Python OpenAI SDK 自定义 Base URL 接入 59API 完整指南
为什么要为 OpenAI SDK 配置自定义 Base URL
OpenAI Python SDK 将请求地址、鉴权和聊天接口封装为统一调用方式。只要服务商兼容 OpenAI API 协议，就可以通过 base_url 替换默认地址，而不必重写业务代码。59API 提供兼容 OpenAI SDK 的 API 中转服务，入口为 https://api.59api.com，支持按量付费调用 GPT 以及 Claude Opus、Sonnet、Haiku、Fable 等模型。对于需要控制推理成本、同时保留官方质量模型能力的团队，这种接入方式尤其直接。
1. 创建环境并安装 SDK
建议使用独立虚拟环境，避免项目依赖互相污染。Python 3.9 及以上版本通常更适合部署当前 SDK。安装命令为：
python -m venv .venv
source .venv/bin/activate
pip install -U openai
随后在 59API 控制台创建 API Key。不要把密钥写进 Git 仓库、前端代码或日志；本地开发可通过环境变量保存，例如：
export API_59API_KEY="你的密钥"
Windows PowerShell 可使用：$env:API_59API_KEY="你的密钥"。生产环境则应由部署平台的密钥管理或环境变量配置注入。
2. 初始化带自定义地址的客户端
OpenAI 兼容接口通常使用 /v1 路径，因此将 59API 地址配置为 https://api.59api.com/v1。核心是实例化 OpenAI 时显式传入 base_url，而不是修改全局请求逻辑：
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["API_59API_KEY"], base_url="https://api.59api.com/v1")
这种写法使模型服务地址成为明确的应用配置。将其放进 settings 模块或依赖注入容器后，测试环境、预发布环境和生产环境可分别使用不同的密钥与地址，而业务层只依赖同一个 client。
3. 发送第一条聊天请求
完成初始化后，调用方式与 OpenAI 官方 SDK 一致。先在 59API 的模型列表中确认可用模型 ID，再替换下面的示例值：
response = client.chat.completions.create(model="gpt-4o-mini", messages=[{"role": "system", "content": "你是严谨的中文技术助手。"}, {"role": "user", "content": "用三点解释 Python 类型注解。"}], temperature=0.3)
print(response.choices[0].message.content)
Claude 模型也应遵循控制台展示的模型 ID。不要自行猜测名称或将供应商品牌名直接当作 model 参数；模型 ID 是请求能否成功和准确计费的依据。
4. 在应用中使用流式响应
聊天机器人、命令行工具和长文本生成更适合流式输出，可缩短用户等待首字的时间。只需在同一请求中加入 stream=True，并逐段读取增量内容：
stream = client.chat.completions.create(model="gpt-4o-mini", messages=[{"role": "user", "content": "写一段 Python 示例。"}], stream=True)
for chunk in stream: print(chunk.choices[0].delta.content or "", end="")
Web 服务中应将这些片段转发为 SSE 或 WebSocket 消息，并在客户端断开时取消上游任务，避免无效生成继续消耗额度。
5. 上线前的稳定性与成本检查
- 设置超时和重试：对网络超时、429 和临时 5xx 错误使用有限次数的指数退避重试；不要对认证失败或参数错误盲目重试。
- 记录必要信息：记录请求 ID、模型 ID、耗时、输入输出 token 和错误类别，但绝不记录 API Key、用户隐私内容或完整敏感提示词。
- 限制输入规模：在进入模型前裁剪历史对话、校验文件大小，并为每个任务设置合理的 max_tokens，避免一次请求产生不可控费用。
- 建立模型路由：将简单分类、摘要任务交给更经济的模型，把复杂推理或高质量写作分配给更强模型，获得更好的成本与效果平衡。
59API 的按量付费模式适合先小规模验证真实 token 消耗，再逐步扩大流量；其提供官方质量模型能力，避免为了节省成本而牺牲输出可靠性。需要接入 GPT 与 Claude 并希望降低开发和调用门槛时，可前往 59API 注册账号，创建密钥后用上述配置完成迁移。