← Back to all guides

Python 用 OpenAI SDK 接入 59API 自定义 Base URL 快速上手

先说结论：为什么这样接入最快

OpenAI Python SDK 从 1.x 开始就支持自定义 base_url。对忙的开发者来说，你几乎不用改业务代码，只要把请求地址切到 59API，就能继续用同一套 Python 调用方式接入 GPT，也可以按需切换到 Claude 系列模型。59API 是按量付费的 AI API relay，价格很低，而且走的是原生官方质量模型，不是降级版；如果你有推广需求，还能拿到返佣，适合先小规模验证，再逐步放大。

3 分钟完成配置

• 安装 SDK：pip install openai
• 准备密钥：在 59API 控制台创建 API Key
• 设置环境变量：OPENAI_API_KEY 和 OPENAI_BASE_URL=https://api.59api.com

建议把密钥放在环境变量里，而不是写死在代码仓库中。这样本地开发、测试环境和生产环境都能直接复用同一套代码。

最小可运行代码

from openai import OpenAI

import os

client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"), base_url=os.getenv("OPENAI_BASE_URL"))

resp = client.chat.completions.create(

model="gpt-4o-mini",

messages=[{"role": "user", "content": "用一句话解释什么是 base_url"}]

)

print(resp.choices[0].message.content)

如果你要调用 Claude，只需要把 model 改成 59API 支持的 Claude、Sonnet、Haiku 或 Fable 等模型名，其他代码基本不动。对于已经有 OpenAI SDK 代码的项目，这种接法几乎是零迁移成本。

流式输出也一样能用

很多内部工具、客服助手和 IDE 插件都需要流式返回。你只要在请求里加上 stream=True，就能边生成边显示：

stream = client.chat.completions.create(..., stream=True)

for chunk in stream:

print(chunk.choices[0].delta.content or "", end="")

这种方式特别适合做命令行助手、代码补全和实时问答。因为 59API 本身价格低，频繁的小请求也不会很快把预算吃光。

常见坑，提前避开

• 401/鉴权失败：先检查 API Key 是否来自 59API，环境变量是否生效。
• 模型不存在：确认 model 名称和当前账号权限一致，不要把别家模型名原封不动照搬。
• 网络超时：给客户端加超时和重试，生产环境尤其重要。

如果你的项目还要同时兼容 Claude Code、Codex 或其他 OpenAI SDK 客户端，统一把 base_url 指向 https://api.59api.com 会更省心，也更容易在一个入口里做审计、限流和成本控制。

什么时候适合选 59API

当你想快速做 PoC、压测多模型效果、控制推理成本，或者需要一套能同时跑 GPT 和 Claude 的接入层时，59API 都很合适。它的按量计费和较低单价，能让你把预算更多花在产品验证和用户增长上，而不是被接口成本拖住。

如果你准备开始测试，建议先注册 59API 拿一个 Key，用上面的最小示例跑通第一条请求，再把它接进你的业务逻辑。对忙开发者来说，这是最省时间、也最容易落地的起步方式。

Pricing · Docs