Responses API 兼容接入与 SSE 流式响应

非流式请求

使用 Bearer API Key 鉴权，并把模型替换为当前密钥可访问的真实 ID。

curl

curl https://quickaicode.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $QUICKAICODE_API_KEY" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "input": "用三点说明如何设计稳定的 API 客户端"
  }'

开启 SSE 流式响应

在请求体加入 "stream": true。连接建立后，服务端会逐步发送事件，客户端应边读边解析，而不是等待整个响应体结束。

curl -N

curl -N https://quickaicode.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $QUICKAICODE_API_KEY" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "input": "输出一段简短的 TypeScript 示例",
    "stream": true
  }'

-N 会关闭 curl 的输出缓冲，便于直接观察事件到达时间。

处理关键事件

OpenAI 官方 Responses 流式接口常见事件包括 response.created、response.output_text.delta、response.completed 和 error。本站会尽力保持兼容，但客户端仍应容忍未知事件并以实际返回为准。

开始

收到创建类事件后初始化本次响应状态，并保存响应 ID。

增量

只追加 delta 内容，不要把每个事件误当成完整消息覆盖界面。

完成或错误

完成时落盘用量；错误时保留请求 ID，并决定是否有限重试。

与 Chat Completions 的区别

Responses API

使用统一的 input 与类型化事件，更适合 Codex 和新的代理式工作流。

Chat Completions

使用 messages 和 choices delta，适合现有 OpenAI 兼容客户端。

两种入口可能由本站做分流或格式转换，转换能力不等于对应上游原生支持全部字段。

超时与重试

分别设置连接超时、等待首事件超时和流式空闲超时。
401、403 等认证错误不应盲目重试；先修复密钥或权限。
429、部分 5xx 或网络中断可使用指数退避与随机抖动有限重试。
流式响应中断后，除非业务具备幂等设计，否则不要直接拼接两次生成结果。

当前兼容边界

不要从官方能力反推本站能力

OpenAI 官方文档中的内建工具、响应存储、background、WebSocket、远程 MCP、previous_response_id 等能力，不代表本站所有模型与分组均已支持。使用前应先在测试环境验证具体字段。

Quick AI Coding 与 OpenAI 无隶属或官方合作关系。本页对官方事件名称的说明仅用于解释兼容格式。

Responses API 兼容接入指南