ZeroFA API

Responses API

OpenAI 新一代接口,支持 input、有状态对话、联网搜索等托管工具和事件式 SSE。ZeroFA 将请求原样转发到 OpenAI 协议上游,并按 token 计费。

POSThttps://zerofa.ai/v1/responses
Responses 是 OpenAI 独有接口,仅 OpenAI 协议上游可用。阿里、火山、Claude 和 Gemini 上游不支持;如果没有真实 OpenAI 渠道,将返回上游错误。

与 Chat Completions 的区别

  • 请求使用 input 而不是 messages,并可通过 store 与 previous_response_id 保存对话状态,后续请求无需重复发送历史。
  • 支持 OpenAI 托管工具,包括联网搜索、文件检索、代码解释器和电脑操作。
  • 流式响应使用事件式 SSE,例如 response.output_text.delta,而不是普通 data chunk。

请求与计费

请求体会原样转发到上游 /v1/responses,input、tools、store、previous_response_id 和 reasoning 等字段均可生效。OpenAI SDK 的 base_url 请使用当前环境的 Base URL 加 /v1。

费用根据响应中的 input_tokens 和 output_tokens 乘以模型单价计算。

可用模型

可用模型包括路由到 Responses 兼容 OpenAI 上游的 GPT 系列模型。详情见 模型广场

请求与响应体

用下面的示例确认请求格式与返回结构。需要在线发起请求时,点击页面顶部“调试”拉起在线运行面板。

curl https://zerofa.ai/v1/responses \
  -H "Authorization: Bearer sk-zerofa-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "input": "用一句话介绍你自己"
  }'