开发接入 · Python SDK

openai Python SDK:只改一个 base_url

官方 SDK 默认连 api.openai.com,换成中转站只需要改 base_url,其余代码一行不动。

安装与初始化

安装bash
pip install -U openai
client.pypython
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)

用环境变量更安全

bashbash
export OPENAI_API_KEY=sk-你的密钥
export OPENAI_BASE_URL=https://hardysapi.com/v1

SDK 会自动读取这两个变量;代码里连 OpenAI() 都不用带参数。 生产环境不要把密钥写进仓库。

流式

stream.pypython
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)

异常对照

异常类状态码处理
AuthenticationError401检查密钥与协议
PermissionDeniedError403分组是否含该模型
NotFoundError404模型名/路径
RateLimitError429退避重试
APITimeoutError—调大 timeout,长任务用流式

SDK 内置了 2 次重试,可用 max_retries 调整;超时用 timeout 参数(默认 600s)。

常见问题

为什么 base_url 必须带 /v1?

SDK 会在 base_url 后拼接 /chat/completions,缺 /v1 会请求到错误路径。

SDK 会自动重试吗?

会,默认对连接错误和 408/409/429/5xx 重试 2 次,可用 max_retries 调整。