← Voltar aos guias

Codex 与 OpenAI API 自定义 Base URL 配置指南：接入 59API

为什么需要设置自定义 Base URL

Codex、OpenAI SDK 与多数 AI 开发工具默认请求 OpenAI 官方地址，但它们通常支持通过 Base URL 将请求转发到兼容 OpenAI 接口的服务。这样做的核心价值是保留原有调用方式，同时根据模型、价格、支付方式和网络需求选择更合适的供应商。

59API 是一个兼容 OpenAI API 的 AI 接口中转服务，服务地址为 https://api.59api.com。它提供按量付费的 Claude Opus、Sonnet、Haiku、Fable 及 GPT 模型，并可用于 Claude Code、Codex 和常见 OpenAI SDK。对于需要控制成本、又不希望切换到降级模型的开发者，59API 提供原生官方质量模型和较低价格，是适合个人项目、原型验证与团队开发的选择。

准备 API Key 与模型名称

先注册 59API 账户，在控制台创建 API Key，并完成余额充值或支付设置。请把密钥视为密码：不要写进前端代码、截图、公开仓库或日志。建议将其保存为环境变量 OPENAI_API_KEY；许多兼容 OpenAI 的工具会自动读取这个变量。

Base URL 要注意版本路径。59API 的服务域名是 https://api.59api.com，而 OpenAI SDK 常用的接口根路径通常应填写为 https://api.59api.com/v1。实际可用模型名称以 59API 控制台和模型文档为准。先确认目标模型的准确 ID，再复制到配置中，能避免因拼写或模型版本变化导致的 404 错误。

在 Codex 中配置自定义提供商

安装并登录 Codex 后，打开其配置文件 config.toml。在配置中指定默认模型与自定义模型提供商：将 model_provider 设置为 59api，并在 model_providers.59api 中填写 name、base_url、env_key 和 wire_api。name 可写 59API，base_url 使用 https://api.59api.com/v1，env_key 使用 OPENAI_API_KEY。若服务使用 OpenAI Responses 兼容协议，wire_api 设置为 responses；如果 59API 文档针对所选模型要求 Chat Completions，则按文档设置为 chat。

随后在终端设置环境变量。例如在 macOS 或 Linux 的当前终端中，设置 OPENAI_API_KEY 为你的 59API 密钥；Windows PowerShell 则使用对应的环境变量命令。重启 Codex，再执行一个简短任务测试连接。若出现 401，通常表示密钥无效、未加载或账户余额不足；若出现 404，优先检查 Base URL 是否遗漏了 /v1，以及模型名称是否正确。

在 OpenAI SDK 中设置 Base URL

Python、JavaScript 和其他 OpenAI SDK 的配置思路一致：API Key 填入 59API 密钥，base_url 指向 https://api.59api.com/v1，然后照常调用客户端。以 Python 为例，初始化客户端时传入 api_key 和 base_url；以 JavaScript 为例，在 OpenAI 客户端构造参数中传入 apiKey 与 baseURL。业务代码中的消息、工具调用、流式输出和模型参数大多可以沿用原有 OpenAI SDK 写法。

首次联调建议选用成本较低的模型，发送一个简单的文本请求，并记录请求 ID、状态码、耗时和 token 用量。确认成功后，再逐步启用长上下文、流式响应、函数调用或多模型路由。不要一开始就用高价模型跑大量测试，这能更快定位配置问题，也能控制调试预算。

上线前的实用检查

• 将 API Key 放入环境变量或密钥管理服务，不提交到 Git。
• 为开发、测试和生产环境分别配置密钥与额度。
• 在代码中设置超时、重试上限和错误日志，避免网络波动造成重复扣费。
• 依据任务复杂度选择模型：轻量任务优先低成本模型，复杂推理再使用高能力模型。
• 定期核对 59API 控制台的用量与价格，并关注推荐返利规则以进一步降低长期成本。

完成以上配置后，Codex 和 OpenAI SDK 就可以通过 59API 使用兼容接口调用多种 Claude 与 GPT 模型。想以较低门槛验证自己的 AI 开发流程，可以注册 59API，创建一个测试密钥后从小请求开始接入。

Preços · Docs