OpenAI Responses 响应接口

用 OpenAI Responses 格式发送输入。本页演示 HTTP 流式请求，Codex 客户端设置见相关指南。

接入准备

按快速开始获取 API Key，并选择支持直接 HTTP 调用的接入点。示例从 ICODEEASY_API_KEY 读取 Bearer Token。将 YOUR_MODEL_ID 换成所选接入点支持的模型 ID。

请求示例

model 指定模型，input 提供输入，stream: true 开启 SSE。

curl -N -sS https://api.icodeeasy.cc/v1/responses \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "YOUR_MODEL_ID",
  "input": "Say hello.",
  "stream": true
}'

读取响应

拼接 response.output_text.delta 事件的 delta。response.completed 表示成功。response.incomplete 带有未完成原因，见 response.incomplete_details。response.failed 或 error 表示失败，即使 HTTP 状态已经是 200。

event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":"Hello!"}

event: response.completed
data: {"type":"response.completed","response":{"id":"resp_example","status":"completed","usage":{"input_tokens":10,"output_tokens":4,"total_tokens":14}}}

在终态事件的 response.usage 中读取 input_tokens 和 output_tokens。如果有 input_tokens_details.cached_tokens，它是输入 Token 的缓存命中部分。