很多人测试 API 中转时,只问一句“你好”,收到回复就认为线路可用。
但 Codex 真正修改仓库时,还要连续经历:读取项目、长上下文、SSE 流式返回、工具调用、执行测试、失败重试和用量结算。短问答成功,只能证明最短链路通了。
下面是一套15 分钟真实仓库验收法。它不仅适用于某一家 API,也可以用于比较任何兼容线路。
1. 先确认 Codex 配置位置
OpenAI 官方 Codex 文档说明,自定义 Provider 由base_url、wire API、认证方式等组成。Provider 应配置在用户级~/.codex/config.toml;项目里的.codex/config.toml不能覆盖model_provider、model_providers等认证相关设置。
model = "你的可用模型名" model_provider = "your_gateway" [model_providers.your_gateway] name = "Your Gateway" base_url = "https://你的网关地址/v1" env_key = "OPENAI_API_KEY" wire_api = "responses"安全提醒:API Key 只放在本机环境变量或安全凭据存储中,不要粘贴到网页、截图、公开仓库、Issue 或群聊。
2. 用同一个任务跑 15 分钟
选择一个失败也不会造成损失的小仓库,给所有候选线路使用完全相同的任务:
- 只读理解:找到入口文件、测试命令和一条关键调用链。
- 跨文件小改:修改一个实现文件和一个测试文件,先说明计划。
- 执行验证:运行测试;失败时读取错误并修复一次。
- 记录数据:总耗时、是否完成、重连次数、工具调用是否闭环、输入输出用量和实际扣费。
真正需要检查的是:
- Responses API 是否能持续返回事件;
- SSE 是否无故停住、重复或提前结束;
- 工具调用结果返回后能否继续推理;
- 长任务失败后是否有明确错误;
- 模型名、用量与最终扣费能否核对。
3. 四类常见故障怎么判断
401 / Unauthorized
先确认启动 Codex 的进程能读取配置中env_key指向的环境变量,再检查 Key 是否属于当前网关。不要通过打印完整 Key 来验证。
model not found
模型展示名不一定等于请求 ID。以网关控制台当前显示的精确模型名为准,修改后重启 Codex。
短问答正常,长任务断流
重点观察 SSE 空闲超时、上游事件兼容、工具结果回传和重试策略。首字快并不能证明线路适合真实编码。
标价不高,实际消耗却很快
用同一个任务比较输入、输出、缓存、重试次数和最终扣费。没完成的反复重试同样消耗时间与额度。
4. 我给自己设的扩量门槛
连续完成 3 次同类任务、工具调用闭环、账单可核对、失败时有可诊断错误。达不到,就不扩量。
说明:本文由 VidAI/胃袋AI团队维护,团队同时提供商业 API 服务。上述验收方法可用于比较任意兼容线路;模型、价格和线路表现会变化,以控制台和实时状态为准。