API 参考
Responses
调用 Responses 接口,区分原始输出、SDK 便捷属性和状态能力。
请求与前提
Responses 是 Codex CLI 等客户端使用的协议。请确认当前模型和线路支持该协议,按 API 概览设置密钥后执行 Bash 示例。
curl --fail-with-body 'https://gateway.irouter.io/v1/responses' \
-H "Authorization: Bearer $IROUTER_API_KEY" \
-H 'Content-Type: application/json' \
--data '{"model":"<model-id>","input":"Reply with a short greeting.","stream":false}'model 指定模型,input 提供输入。需要角色化历史时,使用协议支持的消息项数组。instructions、工具与输出格式等字段应逐项确认兼容性。
读取输出
原始响应的 output 数组可包含多种项。提取 type: message 中 content 的 output_text 文本块,不要假定数组首项就是回答。SDK 的 response.output_text 是便捷属性,不应据此假定原始 HTTP JSON 必有同名顶层字段。
检查 status、错误或未完成信息,再将结果交给用户。文本为空时还可能是工具请求或其他输出项。
流式和会话
设置 stream: true 后按 Responses 事件类型处理,例如文本增量与完成事件。它的事件结构不同于 Chat Completions。见流式输出。
基础文本兼容不代表 previous_response_id、持久化检索、后台任务、内置工具或 WebSocket 全部可用。应用可先自己维护历史并随请求提交;依赖状态功能时需对目标线路单独验收。
继续阅读 Codex CLI;协议参考 OpenAI Responses。