跳转到主要内容
Responses API 形状（OpenAI 为 o1 / o3 / GPT-5 + Agents SDK 引入）—— 由 ByteSpike 像其他端点一样计费和服务。底下网关把 Responses 形状的请求翻译 成各模型的原生协议，所以你可以把 OpenAI SDK + Agents SDK + Codex CLI 指向 ByteSpike，让它跑在 Claude、Gemini、DeepSeek 等模型上。

​
何时使用

  • OpenAI Agents SDK —— SDK 默认讲 Responses 形状
  • Codex CLI —— 内部用 Responses；ByteSpike 通过 --responses-base-url https://llm.bytespike.ai/v1 直接接入
  • 多轮 agent + 结构化输出 —— response_format 加 reasoning 块装在同一个信封里
  • 跨模型一致 —— 你想要一种客户端形状打通 o-series、GPT-5 和 Claude 家族
只是普通聊天、不需要 reasoning 步骤的话，优先用 /chat/completions。要 Anthropic 原生的 tool_use + cache_control，用 /messages。

​
请求

curl https://llm.bytespike.ai/v1/responses \
  -H "Authorization: Bearer $BYTESPIKE_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-5-5",
    "input": "What is the capital of France?"
  }'

​
请求头

Header是否必填说明
Authorization是Bearer sk-byts-… —— Responses 唯一接受的鉴权形式。
content-type是application/json。

​
Body（精选字段）

Responses API 字段众多；ByteSpike 把完整 schema 转发给你请求的 model。常用字段：
字段类型是否必填说明
modelstring是目录 slug（gpt-5-5、claude-opus-4-8、gpt-5-4-mini 等）。
inputstring | array是对话内容。string = 单条 user 消息；array = 多轮（role/content 形状按 OpenAI Responses spec）。
instructionsstring否相当于 system prompt 位。
toolsarray否Responses 形状的工具定义（{type, name, parameters, …}）。
tool_choicestring | object否auto / none / required / {type: "function", function: {name}}。
temperaturenumber否默认 1.0。
top_pnumber否Nucleus sampling。
max_output_tokensinteger否输出 token 上限。
reasoningobject否{"effort": "low" | "medium" | "high"} —— 用于 o-series 和 GPT-5 reasoning 模型。
response_formatobject否{"type": "json_object"} 或 {"type": "json_schema", "json_schema": {...}}，用于严格结构化输出。
streamboolean否SSE 推流。与 OpenAI Responses 规范相同的事件协议。
metadataobject否{"user_id": "..."} —— 转发给模型 + 记录。
previous_response_idstring否多轮串联；引用前一个 response.id。

​
响应

{
  "id": "resp_01HQX9F2P6Y8VEX3CRZ8GXJVD9",
  "object": "response",
  "created_at": 1716700000,
  "model": "gpt-5-5",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "id": "msg_01ABC",
      "role": "assistant",
      "content": [
        {"type": "output_text", "text": "Paris."}
      ]
    }
  ],
  "usage": {
    "input_tokens": 9,
    "output_tokens": 2,
    "total_tokens": 11
  }
}

​
响应字段

字段类型说明
idstring服务端生成的 id，前缀 resp_。用于 previous_response_id 串联。
statusstringcompleted、in_progress、failed。非流式成功恒为 completed。
outputarray输出项数组。每项有 type —— message、reasoning、tool_call 等。
usage.input_tokensinteger输入计费 token 数。
usage.output_tokensinteger输出计费 token 数（o-series 包含 reasoning token）。
usage.reasoning_tokensinteger应用时为隐藏 reasoning 使用的 output_tokens 子集。

​
计费类请求头

与其他端点一致的配额信封： 
X-RateLimit-Limit: 50.00
X-RateLimit-Remaining: 42.18
X-RateLimit-Reset: 1716705600
X-Quota-Remaining-Credits: 192.40
详见 API 参考总览。

​
流式

带上 "stream": true： 
curl -N https://llm.bytespike.ai/v1/responses \
  -H "Authorization: Bearer $BYTESPIKE_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-5-5",
    "input": "Tell a 3-sentence story.",
    "stream": true
  }'
SSE 流逐字节兼容 OpenAI Responses 的流式协议 —— response.created、 response.output_text.delta、response.completed 等。

​
跨模型路由

同一种 Responses 请求形状可打目录里每个模型。按 model 字段选择：
模型家族示例 slug说明
GPT-5 / o-seriesgpt-5-5、gpt-5-4、gpt-5-4-mini原生 Responses 形状 —— 无需翻译。
Claudeclaude-opus-4-8、claude-sonnet-4-6、claude-haiku-4-5reasoning 映射到 Claude 的 thinking 块。
Geminigemini-3-1-pro、gemini-2-5-flash完整支持 Responses 表面。
翻译路径保留 tool_use / tool_calls、结构化输出（response_format）和 reasoning tokens。不论用哪个模型，你拿到的输出形状始终是 Responses-API。

​
错误

OpenAI 信封（与 OpenAI Responses 规范一致）： 
{
  "error": {
    "message": "Model \"foo-3\" not found",
    "type": "invalid_request_error",
    "code": "model_not_found"
  }
}
HTTPcode触发
400invalid_request_errorJSON 错误、缺 model、tools 不合法。
401authentication_errorkey 缺失 / 已撤销。
402insufficient_balance账户 credits 用尽。在 console.bytespike.ai 充值。
413invalid_request_error（body too large）prompt + 工具 schema 超过 body 上限。
429rate_limit_exceeded见速率限制章节。
502 / 503api_error瞬时超时或路由分组中暂无可用容量来服务该 model。Console → Models 中的 dial-test 可帮助排查。

​
价格

按 1k token 计费。与该模型在原生端点的价格相同 —— 翻译开销不计费。 价格实时卡片：bytespike.ai/pricing。

​
相关