2026 Codex 自定义 Base URL 指南:通过 59API 接入 OpenAI API
先分清 Base URL、密钥与模型 ID
为 Codex 或 OpenAI SDK 更换接口地址,需要同时配置三项:Base URL、对应平台的 API 密钥,以及该平台接受的模型 ID。只改地址、继续使用另一平台的密钥,通常会收到认证错误。
59API 的 API 域名是 https://api.59api.com。以下按常见的 OpenAI 兼容路径 https://api.59api.com/v1 演示;实际路径以控制台文档为准。Base URL 不应包含 /chat/completions 或 /responses,客户端会追加具体接口路径。
第一步:准备密钥并确认模型 ID
在 59API 控制台创建密钥,检查可用余额和模型权限。macOS、Linux 的 Bash 或 Zsh 终端可执行:
export FIFTYNINE_API_KEY='替换为你的59API密钥'
Windows PowerShell 使用:
$env:FIFTYNINE_API_KEY='替换为你的59API密钥'
这些设置只对当前终端及其子进程生效。不要把真实密钥提交到 Git,也不要将含密钥的命令截图公开。
在 Bash 或 Zsh 中查询模型列表:
curl -sS https://api.59api.com/v1/models -H "Authorization: Bearer $FIFTYNINE_API_KEY"
例如,你可以寻找 GPT-6 Astra 对应的条目。请求参数必须使用返回结果中的 id;展示名称不一定等于接口 ID,不要自行添加连字符或改写大小写。若平台未开放模型列表接口,请从控制台复制准确 ID。
第二步:用 OpenAI SDK 验证接口
先执行 python -m pip install -U openai,再把下面内容保存为 Python 文件并运行。将 MODEL_ID 替换为实际 ID;分号用于把完整示例放在一行:
import os; from openai import OpenAI; client = OpenAI(api_key=os.environ["FIFTYNINE_API_KEY"], base_url="https://api.59api.com/v1"); response = client.responses.create(model="MODEL_ID", input="请只回复:连接成功"); print(response.output_text)
这一步同时验证认证、路径、模型权限和 Responses API。OpenAI 兼容并不保证所有接口都已实现:Chat Completions 请求成功,不能单独证明 Codex 所需的 Responses 接口可用。若此处失败,先定位原因再配置 Codex。
第三步:为 Codex 配置独立提供商
准备好当前 Codex 版本支持的 Node.js 环境,然后执行 npm install -g @openai/codex。通过 codex --version 确认安装结果。
打开用户目录中的 ~/.codex/config.toml;Windows 对应用户目录下的 .codex 文件夹。将以下各行依次写入文件,并替换 MODEL_ID。如果已有配置,请修改对应字段,避免重复声明。
model = "MODEL_ID"
model_provider = "59api"
[model_providers.59api]
name = "59API"
base_url = "https://api.59api.com/v1"
env_key = "FIFTYNINE_API_KEY"
wire_api = "responses"
前两行是顶层配置,应放在任何表声明之前。然后在已设置密钥的同一终端运行 codex,先做一个简单问答,再测试读取项目文件等实际任务。这里的 env_key 告诉 Codex 从哪个环境变量读取密钥。
OpenAI SDK 与 Codex 的配置入口不同:SDK 可以显式传入 base_url;Codex 应配置自己的提供商,不能假定设置 OPENAI_BASE_URL 后就会自动生效。
遇到错误,按状态码缩小范围
- 401:检查密钥是否属于 59API,以及启动 Codex 的终端是否继承了环境变量。
- 403:检查账户状态、模型权限和平台返回的限制说明。
- 404:核对 /v1 路径、模型 ID,以及目标模型是否支持 Responses API。
- 429:查看错误正文,区分余额、配额与速率限制;限流时降低并发并采用退避重试。
- 流式输出中断:检查代理超时、流式转发和工具调用兼容性,不要仅凭一次普通问答判断全部功能正常。
为什么考虑通过 59API 接入
59API 提供低价、按量计费的多模型接入,适合个人开发、脚本任务和需要控制调用成本的团队。平台主打原生官方品质模型、不降级,并提供推荐返佣;具体价格与活动规则以控制台为准。
比较成本时,也要记录完成一次任务的总费用、延迟和重试次数。可以注册 59API,先用少量余额跑通上述流程,再用自己的项目评估效果,并固定已验证的客户端版本与模型 ID。
शुरू करने के लिए तैयार?
कुछ ही मिनटों में Claude और GPT जोड़ें, सबसे कम कीमत पर। साइन अप करें और API key पाएं।
मुफ़्त साइन अप