Browse documentation
Codex 配置
使用专用的 Codex 渠道调用 Codex。请在控制台创建 API Key,并将类型选择为 Codex。Codex 按 1 倍速度消耗购买额度,但不会改变你购买的 Token 额度。
GPT 模型請使用 Codex 渠道的 Key。
模型與即時價格
請使用 Codex 金鑰呼叫已設定的 GPT 模型。全部模型價格提供各模型價格頁;GPT-6.1 Sol 與 Terra 比較說明這兩個模型的差異與相容的推理設定。
目前的額度費率是 AI in IDE 設定的模型價格 × Codex 渠道倍率,可能與供應商參考價格不同。請查看 Sol 與 Terra 頁面的即時額度費率。額度消耗與購買額度的實付金額不同;可用成本估算器估算購買費用。
GPT-5.6 和 GPT-6 的标准费率适用于不超过 272K 输入 Token 的请求。超过 272K 时,整次请求的输入及缓存价格翻倍,输出价格为 1.5 倍。GPT-5.6 和 GPT-6 默认的 30 分钟缓存写入按基础输入价格的 1.25 倍计费。详见 OpenAI 官方的 GPT-5.6 Sol、Astra 和 GPT-6 Sol 价格。
GPT-6.1 Terra 沿用相同的上下文与服务档位规则,基础价格见官方模型文档。GPT-5.6 和 GPT-6 的 30 分钟缓存写入为输入价的 1.25 倍,12 小时为 2.5 倍。通过 prompt_cache_options.ttl 或 prompt_cache_breakpoint.ttl 设置 "12h";混合缓存时长按响应返回的各时长写入 Token 数分别结算。详见缓存文档。
GPT-5.6 和 GPT-6 的 Fast 費率為標準費率的 2 倍。这些模型的 Flex 费率为 0.5 倍,以响应中的 service_tier 为准。未指定档位时,渠道明确使用 default。未配置价格的档位(包括 ultrafast)会被拒绝。详见 OpenAI Fast 价格。
内置 Web search 每次搜索额外消耗 $0.010(已计入 Codex 渠道 1 倍系数);打开搜索结果页面不另收搜索调用费。非推理模型的预览版搜索每次消耗 $0.025。Chat 搜索模型也会产生搜索费。由于无法验证向量库归属,此渠道禁用 File search。托管 Code Interpreter、托管 shell 和图片生成工具暂不支持,因为其独立使用费无法在此准确计算。详见 OpenAI 工具价格。
GPT-5.6 和 GPT-6 未指定 max_output_tokens 时默认限制为 32,768,可显式设到最多 128,000。任意 Codex 模型的内置搜索工具默认最多调用 5 次,也可设置 max_tool_calls。请在请求中直接传入对话历史。所有 Codex 模型都拒绝引用服务端保存的上下文(previous_response_id、conversation 或提示词 ID)、历史音频 ID,以及远程文件和图片。
客户端断开后,代理最多再等 15 秒接收最终用量,单次上游请求最长 15 分钟。支持存储的响应可以按原操作 ID 补查回执,只有确认的实际用量才会扣费。
Responses 的搜索工具支持通过 max_tool_calls 设置 0–20 次调用。共享凭证不支持私有隧道、远程 MCP 工具或自定义音色 ID。支持音频的模型分别按文本和音频 Token 计费。
API Key 和实际扣费账户的余额都大于 0 时即可发起生成请求。请求的输出和工具上限按原设置转发,完成后按实际用量结算;并发请求可能让余额变成负数。
Codex CLI
使用 Node.js 18 或更高版本安装官方 Codex CLI:
1 npm install -g @openai/codex2 codex --version
CLI 从以下目录读取配置:macOS/Linux 为 ~/.codex,Windows 为 C:\Users\你的用户名\.codex。目录不存在时创建一次即可。
config.toml
在该目录中创建 config.toml:
1 model_provider = "aiinide"2 model = "gpt-6.1-sol"3 model_reasoning_effort = "high"4 disable_response_storage = true5 6 [model_providers.aiinide]7 name = "AI in IDE"8 base_url = "https://api.aiinide.com"9 wire_api = "responses"10 requires_openai_auth = true11 12 [features]13 web_search_request = true
此設定範例使用 gpt-6.1-sol。gpt-5.5 已下線。CLI 會在 Base URL 後加上 /responses。
原有 Base URL 的 /api/codex 和 /api/gemini 前綴繼續支援,原 Key 可沿用。
auth.json
在同一目录创建 auth.json,填入控制台生成的 API Key:
1 {2 "OPENAI_API_KEY": "YOUR_DASHBOARD_API_KEY"3 }
客户端不要使用服务器环境中的 CODEX_API_KEY,CLI 或编辑器只应使用你在控制台创建的 Key。
启动 Codex
进入项目目录并运行:
1 cd your-project2 codex
官方 VS Code Codex 扩展也可以使用相同的 config.toml 和 auth.json。如果扩展提示缺少配置,请检查文件位置,并确认选择的是 Codex 类型的 Key。
Responses API
Responses 接口地址:
1 POST https://api.aiinide.com/responses
请求示例:
1 export CODEX_API_KEY="YOUR_DASHBOARD_API_KEY"2 3 curl --globoff --fail-with-body 'https://api.aiinide.com/responses' \4 -H "Authorization: Bearer $CODEX_API_KEY" \5 -H "Content-Type: application/json" \6 -d '{7 "model": "gpt-6.1-sol",8 "input": "Rewrite this sentence in plain English: The application facilitates the modification of account settings.",9 "reasoning": {"effort": "low"}, "max_output_tokens": 409610 }'
流式请求加入 "stream": true,并使用 curl -N 保持连接:
1 curl --globoff --fail-with-body -N 'https://api.aiinide.com/responses' \2 -H "Authorization: Bearer $CODEX_API_KEY" \3 -H "Content-Type: application/json" \4 -d '{5 "model": "gpt-6.1-sol",6 "input": "Explain this JavaScript function in one sentence: function add(a, b) { return a + b; }",7 "reasoning": {"effort": "low"}, "max_output_tokens": 4096, "stream": true8 }'
這些範例已包含所需輸入,不會讀取本機專案。非串流回應請確認 status: "completed" 與 output[].content[];串流回應請確認 response.completed 事件。若達到輸出上限,請查看 incomplete_details.reason,因為推理 Token 也計入上限。可在用量紀錄確認使用量。
Chat Completions
使用 Chat Completions 格式的 OpenAI 兼容客户端可调用:
1 curl --globoff 'https://api.aiinide.com/chat/completions' \2 -H "Authorization: Bearer $CODEX_API_KEY" \3 -H "Content-Type: application/json" \4 -d '{5 "model": "gpt-6.1-sol",6 "messages": [{"role": "user", "content": "给我一份简短的发布检查清单。"}],7 "stream": false8 }'
接口会校验 Key 的渠道和模型,将请求转发到已配置的 Codex 上游,并在响应后记录用量。Codex 请求不要发送到 /api/anthropic。
常见错误
401:请使用有效且未过期的控制台 Key,并通过Authorization: Bearer ...发送。400:检查模型名称、请求格式,并确认 Key 类型为 Codex。AWSQ/CCMAX Key 不能调用此接口。429:Key 的购买额度、美元额度或请求次数已达到限制。503:Codex 上游暂时不可用,请稍后重试。