与 Chat Completions 的区别
- 请求使用 input 而不是 messages。命中原生链路时可使用 store 与 previous_response_id;转换链路需发送完整历史。
- 函数工具可转换到受支持的文本厂商;联网搜索、文件检索、代码解释器和电脑操作等托管工具取决于上游原生能力。
- 流式响应使用事件式 SSE,例如 response.output_text.delta,而不是普通 data chunk。
请求与计费
原生链路会无损转发请求;转换链路会把 input、instructions、函数工具、结构化输出和通用 reasoning 配置转换为目标厂商协议,并把结果统一编码为 Responses JSON/SSE。OpenAI SDK 的 base_url 请使用当前环境的 Base URL 加 /v1。
费用根据响应中的 input_tokens 和 output_tokens 乘以模型单价计算。
原生资源接口
原生 Responses 创建成功后,平台会保存资源所有权与原 upstream 映射。查询、删除、取消和 input_items 会固定回原渠道,并按创建时使用的用户与 API Key 隔离;转换模式不创建可查询的服务端资源。
- GET /v1/responses/{id}
- DELETE /v1/responses/{id}
- POST /v1/responses/{id}/cancel
- GET /v1/responses/{id}/input_items
后台执行
原生链路支持 background=true。平台在提交前预留估算额度,完成后按上游 usage 原子结算;可用 GET 查询状态、POST cancel 取消,流式中断后可用 stream=true 与 starting_after 继续。当前不提供 Responses webhook,请轮询或恢复 SSE。
辅助端点
compact 与 input_tokens 只调用具备对应原生能力的链路,不转换到 Chat,也不会用本地估算冒充上游精确结果。具体可用性取决于模型路由。
- POST /v1/responses/compact
- POST /v1/responses/input_tokens
可用模型
可用模型包括已配置 Responses 链路的 GPT、Kimi、DeepSeek、GLM、Qwen 等文本模型。详情见 模型广场
请求与响应体
用下面的示例确认请求格式与返回结构。需要在线发起请求时,点击页面顶部“调试”拉起在线运行面板。
curl https://zerofa.ai/v1/responses \
-H "Authorization: Bearer sk-zerofa-xxx" \
-H "Content-Type: application/json" \
-d '{
"model": "your-response-model-id",
"input": "用一句话介绍你自己"
}'