首页 / 模型指南 / GPT-5-Codex

30 秒结论

• 它擅长什么：面向编码与终端 Agent 的版本，配合 Codex CLI / IDE 插件使用，走 /v1/chat/completions 一个端点即可开始。
• 怎么接：把 OpenAI SDK 的 base_url 改成 https://sub.sumcapi.top/v1，api_key 换成苏姆卡皮密钥，模型名填 GPT-5-Codex。
• 注意什么：代码与 Agent 以控制台与模型广场实时展示为准；生产链路请配置超时、退避与兜底模型。

接口与关键参数

鉴权统一使用 Authorization: Bearer <API_KEY>。流式响应请处理 data: [DONE] 与心跳

请求示例

cURL

curl https://sub.sumcapi.top/v1/responses \
  -H "Authorization: Bearer $SUMCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "GPT-5-Codex",
    "input": "给 src/utils/retry.ts 增加指数退避与抖动，并补测试",
    "tools": [{"type": "function", "function": {"name": "apply_patch"}}],
    "reasoning_effort": "medium"
  }'

Python（OpenAI SDK）

# Anthropic 原生 Messages 契约（Claude Code 等工具使用）
curl https://sub.sumcapi.top/v1/messages \
  -H "x-api-key: $SUMCAPI_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "GPT-5-Codex", "max_tokens": 1024,
        "messages": [{"role": "user", "content": "重构这个函数"}]}'

响应要点

• 用量字段在 usage 中返回（输入、输出、缓存读写分列），账单以此为准。
• 建议记录请求 ID：排查问题与计费争议都需要它。
• 同名模型可能由不同渠道提供，输出风格会有细微差异，切模型前做一轮回归。

常见错误与处理

计费口径

• 按 输入 + 输出 token 计费，工具调用与思维链同样计入。
• 编码任务上下文大：务必设置输出上限并做文件截断，避免整仓文件进上下文。
• 更高的推理档位会显著增加输出 token 与耗时，先按中低档测一轮再决定。
• 按项目拆分密钥，成本能直接归因到仓库或团队，见 计费与退款政策。

适用场景

• 代码补全与重构：在 IDE 插件或 CLI 里把 Base URL 指向网关，模型名做成配置项随时切换。
• 自动化 PR：工具调用 + 补丁应用，配合 CI 回归验证。
• 技术文档：读代码库生成接口说明与变更日志。
• 评测与回归：同一批用例跨模型跑分，成本与质量一次对齐。

选型建议

代码补全、重构、自动化 PR。同一能力建议同时配置 2 个以上候选模型，网关会在限流与过载时自动切换，见 路由与错误。

接入三步

1. 在控制台创建密钥并绑定包含该模型的分组；
2. 用上面的示例跑通一次最小请求，确认 messages 返回模型名；
3. 把 model 做成配置项，在 模型广场 对照可用清单，逐步迁移业务链路。

相关模型（代码与 Agent）

想看全部能力入口，见 模型指南 与 能力与场景。

常见问题