创建响应

使用 OpenAI 兼容的 Responses API 生成模型输出。

Responses API 使用统一的输入与输出对象,适合文本或结构化模型输入。

POST/openai/v1/responses

请求体

字段类型必填说明
modelstring是由 AnyInt 路由的模型标识。
inputstring 或 array是文本或结构化输入项。
streamboolean否在支持时返回服务端事件流。
reasoning.effortstring否模型相关的推理强度,按原值转发,不静默降低。
toolsarray否工具声明,支持 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。