API 与错误码
OpenAI Responses 端点
给 Codex CLI 与 OpenAI SDK 的 responses 接口用的那套：同一把密钥、不存会话，以及三处与官方不同的行为。
除了 Chat Completions,网关还提供 OpenAI 的 Responses API:
| 端点 | 用途 |
|---|---|
POST /v1/responses |
Responses 协议的对话补全,请求与响应都不翻译 |
Codex CLI、OpenAI SDK 的 client.responses.create() 用的就是这个端点。
鉴权与地址:和 Chat Completions 一样
Authorization: Bearer 你的密钥
地址也是同一个(带 /v1):
https://api.xisu.ai/v1密钥、余额、套餐、预算与另外两套完全共用 —— 不需要另外申请,用量记在同一个账上。
请求与响应
标准 Responses 形状,model 与 input 必填。max_output_tokens 如果给,
必须是正整数。除模型名外,请求体原样到达上游 —— reasoning、instructions、
function 工具等都不经任何翻译。
响应原样返回。流式是原生 Responses 事件流
(response.created … response.output_text.delta … response.completed),
没有 data: [DONE],别按它写收尾判断。用量只在 response.completed 里出现一次,
字段名是 input_tokens / output_tokens(不是 prompt_tokens / completion_tokens)。
⚠️ 三处与官方不同的行为
1. 不存会话,三个字段会被 400 拒掉
网关不保存你的对话。下面这几个依赖服务端存储的字段会直接返回 400, 而不是悄悄忽略:
| 字段 | 怎么办 |
|---|---|
previous_response_id |
把完整对话放进 input |
background |
不支持后台任务,改用普通请求或流式 |
store: true |
改成 false,或者不传 |
(悄悄忽略的话,上游拿到的是一个没有历史的请求 —— 模型答非所问,而账单照收。 所以这里选择明确报错。)
2. 服务端工具按次另外收费
web_search、file_search、code_interpreter、mcp 这类由上游执行的工具
原样透传,但按次另外收费,不在 token 用量里。
- 只有这个模型配了按次价时才放行;没配价、或工具类型我们还不认识,
返回 400
server_tool_not_priced; function、custom这类你自己执行的工具不按次收费,照常放行;- 带按次收费工具的请求不用预付包抵扣,整笔从余额扣。
3. 这个端点上的模型是子集
只有配了 OpenAI 兼容上游的模型能在这里调。两种失败的下一步正好相反:
| 返回 | 含义 | 怎么办 |
|---|---|---|
404 model_not_on_endpoint |
模型有上游,但那些上游服务不了这个端点 | 永久的,重试没用:换模型,或改走 /v1/chat/completions |
503 no_available_channel |
模型是这个端点的,只是此刻没有可用上游 | 暂时的:按响应里的 Retry-After 退避重试 |
模型广场与控制台「可用模型」里标着 OpenAI Responses 的模型可以走这个端点; 没标的不代表不支持 —— 以实际调用为准。 其余错误码与 Chat Completions 是同一套,见「错误码与限流」。