创建响应
使用 OpenAI 兼容的 Responses API 生成模型输出。
Responses API 使用统一的输入与输出对象,适合文本或结构化模型输入。
/openai/v1/responses请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 由 AnyInt 路由的模型标识。 |
input | string 或 array | 是 | 文本或结构化输入项。 |
stream | boolean | 否 | 在支持时返回服务端事件流。 |
reasoning.effort | string | 否 | 模型相关的推理强度,按原值转发,不静默降低。 |
tools | array | 否 | 工具声明,支持 custom 工具。 |
响应
完成后返回包含标识、状态和生成输出的响应对象。
工具历史与参数错误
自定义工具调用和多段工具输出保持原有顺序、文本与 Unicode 内容。历史 assistant output_text 的 annotations、logprobs 未提供或为 null 时,会在转发前补为合法空数组,避免上游重建消息时产生非法 null。供应商伪心跳消息不会进入对话历史。
推理强度取值由具体模型和上游决定。上游明确拒绝某字段时,响应会包含具体参数,例如 error.code: "invalid_value"、error.param: "reasoning.effort"。无法归因到原请求字段,或由上游转换产生的格式错误,归为上游错误,不将合法工具历史误报为用户输入有误。
流式终止与恢复
正常完成以 response.completed 结束;达到输出限制可返回 response.incomplete。上游失败、超时或提前 EOF 返回 response.failed,不会伪造成功终止,也不使用旧式 [DONE] 标记。即使 HTTP 为 200,也应检查最终事件。流式失败不代表可以自动重放已经发出的推理请求。
心跳使用 SSE 注释行;供应商的 response.metadata、codex.response.metadata、responsesapi.websocket_timing 事件和 SSE-Keep-Alive 输出项会被过滤。事件 sequence_number 保持递增。
x-client-message-id、x-resume-message-id 是按事件偏移恢复的可选扩展。x-anyint-resume-offset-unit: sse-event 说明偏移单位,x-anyint-stream-replayed: true 表示当前为缓存流重放。未启用恢复的客户端可忽略这些扩展响应头。
兼容别名
现有客户端可继续使用 /v1/responses。新接入应使用 /openai/v1/responses。