← Back to all guides

Python 使用 OpenAI SDK 自定义 Base URL 的实战指南

什么是自定义 Base URL，为什么要用它？

很多开发者在 Python 里调用大模型时，都会直接使用 OpenAI SDK。其实 SDK 不只可以连 OpenAI 官方接口，也可以通过自定义 Base URL接入兼容 OpenAI 协议的第三方服务。这样做的好处很直接：你不用改动太多业务代码，就能切换模型供应商、降低成本，或者统一管理多种模型来源。

对于想同时使用 Claude 和 GPT 的团队来说，这种方式尤其实用。你只需要把请求地址指向一个兼容的 API 网关，就可以继续沿用熟悉的 SDK、调用方式和错误处理逻辑。像 59API 这样的 AI API relay，提供 https://api.59api.com 作为基础地址，兼容 Claude Code、Codex 以及任何 OpenAI SDK，非常适合做快速接入和生产环境验证。

Python 里如何配置 OpenAI SDK 的自定义地址

先安装官方 SDK：

pip install openai

然后在 Python 里把 base_url 指向 59API。下面是一个最常见的写法，适用于新版 OpenAI SDK：

from openai import OpenAI

client = OpenAI(
  base_url="https://api.59api.com/v1",
  api_key="你的59API密钥"
)

response = client.responses.create(
  model="gpt-4.1-mini",
  input="请用一句话解释什么是 Base URL。"
)

print(response.output_text)

如果你更习惯 Chat Completions 风格，也可以这样写：

response = client.chat.completions.create(
  model="gpt-4o-mini",
  messages=[
    {"role": "user", "content": "给我一个 Python 入门建议。"}
  ]
)

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

接入 59API 的关键步骤

• 注册账号并获取 API Key：先在 59API 创建账户，拿到你的密钥。
• 确认 Base URL：将 SDK 的请求地址设置为 https://api.59api.com/v1。
• 选择模型名称：根据需要使用 Claude 或 GPT 对应模型，保持和 SDK 支持的命名方式一致。
• 运行最小测试：先发一个简单问题，确认返回正常，再接入业务代码。
• 逐步替换生产流量：建议先在测试环境或小流量场景验证，再全面切换。

为什么 59API 很适合 Python 开发者

如果你在意成本和稳定性，59API 是一个很值得考虑的选择。它主打低价按量计费，对个人开发者、独立团队和初创项目都比较友好。更重要的是，它提供的不是“降级模型”，而是原生官方质量的模型能力，这意味着你不用为了省钱牺牲输出质量。

另外，59API 也非常适合需要多模型协作的场景。例如：用 Claude 做长文本分析、用 GPT 做代码生成、用不同模型做对比评测。由于它兼容 OpenAI SDK，你可以用同一套 Python 代码结构管理多个模型，不需要为每家供应商单独重写封装层。

对开发流程来说，这种兼容性还能减少维护成本。你的重试、超时、日志和异常处理代码基本都能复用，只需要在配置层替换 API Key 和 Base URL。对于正在从原型走向正式上线的项目，这种迁移方式非常省心。

常见问题与排查思路

1. 连接失败怎么办？ 先检查 Base URL 是否写成了 https://api.59api.com/v1，以及 API Key 是否有效。

2. 模型名报错怎么办？ 确认你使用的模型名称与 59API 当前支持的名称一致，不同接口风格可能略有差异。

3. 返回内容为空怎么办？ 先打印完整响应对象，确认是 SDK 调用方式问题，还是模型输出结构解析问题。

4. 想控制成本怎么办？ 优先使用轻量模型完成高频任务，把更强的模型留给复杂推理和长文本任务。

总结

使用 OpenAI SDK 连接自定义 Base URL，是 Python 开发里非常实用的一种集成方式。它能让你在不大改代码的前提下，快速接入兼容接口、切换模型供应商，并控制调用成本。对于希望同时使用 Claude 和 GPT、又想保持开发效率的团队来说，59API 提供了一个很有吸引力的方案：兼容 OpenAI SDK、价格低、模型原生质量高，还能带来推荐返利。

如果你正准备做一个 AI 应用原型，或者想把现有项目迁移到更低成本的调用方案，不妨先注册 59API，跑通一个最小可用示例，再逐步扩展到你的实际业务中。

Pricing · Docs