Codex CLI 接入

Codex CLI 使用 OpenAI 兼容接口。接入 QuotaAPI 时，Base URL 使用 https://quotarouter.ai/v1，认证方式使用 Bearer Token。

环境变量方式

export OPENAI_BASE_URL="https://quotarouter.ai/v1"
export OPENAI_API_KEY="YOUR_QUOTAAPI_KEY"

如果你的工具使用 OPENAI_API_BASE，也可以按工具要求设置为同一个地址：

export OPENAI_API_BASE="https://quotarouter.ai/v1"

推荐检查

先确认模型列表可以访问：

curl https://quotarouter.ai/v1/models \
  -H "Authorization: Bearer YOUR_QUOTAAPI_KEY"

再发送一次 Chat Completions 请求：

curl https://quotarouter.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_QUOTAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      { "role": "user", "content": "Return a short Codex CLI test response." }
    ],
    "max_tokens": 80
  }'

Responses 接口

支持 Responses 的客户端可以调用 /v1/responses：

curl https://quotarouter.ai/v1/responses \
  -H "Authorization: Bearer YOUR_QUOTAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "Write one sentence about QuotaAPI.",
    "max_output_tokens": 80
  }'

部分推理模型会先消耗 reasoning tokens。为了避免上游因输出 token 太低而拒绝请求，建议 max_output_tokens 或 max_completion_tokens 不低于 16。

模型名称

常见 OpenAI / GPT 类型模型命名示例：

模型	适合场景
gpt-5.5	通用推理、代码和多步骤任务
gpt-5.5-mini	快速问答、轻量代码辅助、低成本任务

实际可用模型以控制台分组为准。如果你把某个分组命名为 Codex，只要它对应的是 OpenAI 类型协议，就仍然使用 OpenAI 兼容接入方式。

排查

• OPENAI_BASE_URL 不生效：确认客户端是否读取 OPENAI_API_BASE 或自有配置文件。
• 401：检查 Bearer Token 是否完整，前后不要带空格。
• 400：检查模型名称、请求体字段和 token 参数。
• 403：API Key 没有目标 OpenAI / GPT 类型分组权限。