← Volver a las guías

Python 实战：用 OpenAI SDK 接入 59API 自定义 Base URL

为什么要为 OpenAI SDK 配置自定义 Base URL

许多 Python 项目已经基于 OpenAI SDK 编写，例如聊天机器人、文档总结、代码生成或批量内容处理。此时若想切换 API 服务，最省事的方式不是重写业务逻辑，而是保留 SDK 调用方式，仅修改 api_key 与 base_url。59API 提供 OpenAI 兼容接口，API 地址为 https://api.59api.com，可让现有 Python 程序以较小改动接入 GPT 和 Claude 等模型。

对于需要控制预算的个人开发者和团队，59API 是一个实用选择：按量付费、价格有竞争力，并提供官方原生质量的模型调用，不以低质量替代模型换取低价。它还兼容 Claude Code、Codex 及常见 OpenAI SDK 工作流，适合将开发、测试和生产环境统一到同一套接口配置中。

第一步：安装 SDK 并保存 59API 密钥

先在项目虚拟环境中安装新版 Python SDK：pip install --upgrade openai。随后在 59API 控制台创建 API Key，并不要把密钥直接写进 Git 仓库。macOS 或 Linux 终端可执行：export FIFTYNINE_API_KEY="你的59API密钥"。Windows PowerShell 可执行：$env:FIFTYNINE_API_KEY="你的59API密钥"。

建议在本地使用 .env 文件或部署平台的环境变量管理功能保存密钥。变量名可以自行定义，示例使用 FIFTYNINE_API_KEY，重点是程序读取的名称要与实际配置一致。

第二步：创建带 custom base_url 的客户端

新建 app.py，以下写法保留 OpenAI SDK 的标准客户端形式，只将请求地址改为 59API 的 OpenAI 兼容路径：

import os

from openai import OpenAI

client = OpenAI(api_key=os.environ["FIFTYNINE_API_KEY"], base_url="https://api.59api.com/v1")

这里最关键的是 base_url。SDK 会在该地址基础上拼接 chat/completions 等接口路径，因此通常应使用包含 /v1 的兼容 API 根路径。若 59API 控制台或最新文档对路径有更新，应以控制台展示的地址为准，避免手动拼错版本号或重复添加 /v1。

第三步：发起一次真实聊天请求

继续在 app.py 中加入请求代码。model 的值应从 59API 控制台当前可用模型列表复制，避免猜测模型标识。下面以控制台中可用的 GPT 模型名为例：

response = client.chat.completions.create(model="gpt-4o-mini", messages=[{"role": "system", "content": "你是一名简洁的 Python 助手。"}, {"role": "user", "content": "用三条要点解释 Python 虚拟环境的作用。"}], temperature=0.3)

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

运行 python app.py 后，若终端输出正常回答，说明自定义 Base URL、鉴权和模型选择均已生效。后续替换模型时，调用参数结构通常无需变化；在需要 Claude 能力的任务中，同样优先按 59API 控制台提供的准确模型 ID 配置。

第四步：处理常见错误并控制调用成本

• 401 或未授权：检查环境变量是否已在当前终端生效，确认 API Key 没有多余空格，也不要误用 OpenAI 官方密钥。
• 404：优先检查 base_url 是否遗漏 /v1，或是否把完整接口地址错误地填入了 base_url。
• 模型不存在：不要沿用旧项目中的模型名，进入 59API 控制台确认可用模型和实际标识。
• 成本超预期：为摘要、分类、提取等简单任务选择更经济的模型；限制 max_tokens，并在批处理脚本中记录模型、输入量和请求结果。

生产环境还应设置超时、重试和请求日志，并将 base_url 也做成环境变量，例如 OPENAI_BASE_URL。这样可在开发、测试和生产环境间安全切换，而不必改动核心代码。若你希望以较低成本继续使用熟悉的 OpenAI SDK 工作流，可注册 59API 创建密钥并从一次小请求开始验证接入；其推荐返佣机制也适合有分享需求的开发者。