Responses

Responses 适合使用较新的 OpenAI SDK、Codex CLI 或已经切到 Responses 协议的客户端。

Endpoint

POST /v1/responses

请求体最小结构

{
  "model": "your-model",
  "input": "Hello CodeingForce"
}

常用字段

• model：实际要调用的模型标识。
• input：单轮输入内容，或者由 SDK 组装后的请求体。
• stream：是否开启流式返回。

返回与错误

• 成功时返回 OpenAI Responses 兼容响应结构。
• 失败时返回 { ok: false, error: { message } }。
• 如果是上游请求返回非 2xx，错误对象里还会额外带 error.upstreamStatus。
• 如果上游服务异常，常见状态码是 502 或 503。

联调建议

• 如果你的客户端原生支持 Responses，优先走这一条线。
• 先从 模型列表 里确认模型名。
• 首次联调用非流式，确认返回格式之后再切流式。