官方 SDK 默认连 api.openai.com,换成中转站只需要改 base_url,其余代码一行不动。
pip install -U openai
from openai import OpenAI client = OpenAI( api_key="sk-你的密钥", base_url="https://hardysapi.com/v1", ) resp = client.chat.completions.create( model="claude-sonnet-4-5", messages=[{"role": "user", "content": "用一句话解释什么是向量"}], ) print(resp.choices[0].message.content)
export OPENAI_API_KEY=sk-你的密钥 export OPENAI_BASE_URL=https://hardysapi.com/v1
SDK 会自动读取这两个变量;代码里连 OpenAI() 都不用带参数。
生产环境不要把密钥写进仓库。
with client.chat.completions.create(model=m, messages=msgs, stream=True) as s: for chunk in s: if chunk.choices and chunk.choices[0].delta.content: print(chunk.choices[0].delta.content, end="", flush=True)
| 异常类 | 状态码 | 处理 |
|---|---|---|
| AuthenticationError | 401 | 检查密钥与协议 |
| PermissionDeniedError | 403 | 分组是否含该模型 |
| NotFoundError | 404 | 模型名/路径 |
| RateLimitError | 429 | 退避重试 |
| APITimeoutError | — | 调大 timeout,长任务用流式 |
SDK 内置了 2 次重试,可用 max_retries 调整;超时用 timeout 参数(默认 600s)。
SDK 会在 base_url 后拼接 /chat/completions,缺 /v1 会请求到错误路径。
会,默认对连接错误和 408/409/429/5xx 重试 2 次,可用 max_retries 调整。