Responses

OpenAI 风格的 Responses 接口适合以更统一的输入结构发起文本生成请求，也便于后续承载多模态输入。

请求地址

鉴权方式

使用 Bearer Token 认证，在请求头中传入 API Key：

• Authorization：Bearer YOUR_API_KEY

会话 ID（可选）

为提升上游提示词缓存命中率，建议在每个请求中通过以下任一请求头传入真实且稳定的用户会话 ID；同时传入多个时，按下列顺序取第一个非空值：

• X-Client-User-Id：YOUR_REAL_USER_SESSION_ID
• X-Claude-Code-Session-Id：YOUR_REAL_USER_SESSION_ID
• Session-Id：YOUR_REAL_USER_SESSION_ID

请求示例

首版文档展示文本输入场景。业务侧可继续沿用统一的 API Key 和模型命名。

curl https://api.0xtoken.cn/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-Claude-Code-Session-Id: YOUR_REAL_USER_SESSION_ID" \
-d '{
  "model": "deepseek-v4-pro",
  "input": "Hello!"
}'

请求体示例

一个启用深度思考（thinking）的完整请求体：

{
"model": "deepseek-v4-pro",
"input": "证明根号 2 是无理数。",
"thinking": {
  "type": "enabled",
  "budget_tokens": 4096
},
"stream": false
}

请求字段

thinking 字段说明

thinking 用于控制深度思考（扩展思考链），结构与 Anthropic Messages 接口保持一致：

"thinking": {
  "type": "enabled",        // enabled 启用深度思考，disabled 禁用
  "budget_tokens": 0        // 深度思考预算 Token 数，type=enabled 时生效
}

是否思考的判定规则

平台按以下规则判定一次请求是否启用深度思考：

• thinking.type = "disabled" 或 reasoning.effort = "none"：不思考
• 其余情况（未设置、thinking.type = "enabled"、reasoning.effort 为 minimal/low/medium/high/xhigh/max 等）：默认思考

当 thinking.type 与 reasoning.effort 同时出现且语义冲突时，以显式的 thinking.type = "disabled" 为准（关闭思考），reasoning.effort 的隐含启用不再覆盖显式关闭。

默认 max_tokens

当请求未显式传入 max_output_tokens 时，平台会根据 reasoning.effort（与 thinking 同义）的推理深度自动填充默认的输出 Token 上限。显式传入则以用户值为准，不再覆盖。

注：该默认值仅影响"输出 Token 上限"，深度思考的实际消耗另由 thinking.budget_tokens 控制。

响应字段

响应示例

启用深度思考后的非流式响应，output 中先返回 reasoning 项（思考摘要），再返回 message 项（正文），reasoning_tokens 为思考消耗：

{
"id": "resp_1xtoken",
"object": "response",
"created_at": 1753305600,
"status": "completed",
"model": "deepseek-v4-pro",
"output": [
  {
    "id": "rs_1xtoken",
    "type": "reasoning",
    "summary": [
      { "type": "summary_text", "text": "要证明根号 2 是无理数，使用反证法……" }
    ]
  },
  {
    "id": "msg_1xtoken",
    "type": "message",
    "role": "assistant",
    "status": "completed",
    "content": [
      { "type": "output_text", "text": "假设根号 2 是有理数，则可表示为最简分数 p/q……矛盾，故根号 2 为无理数。", "annotations": [] }
    ]
  }
],
"output_text": "假设根号 2 是有理数，则可表示为最简分数 p/q……矛盾，故根号 2 为无理数。",
"usage": {
  "input_tokens": 12,
  "output_tokens": 180,
  "total_tokens": 192,
  "input_tokens_details": {
    "cached_tokens": 6
  },
  "output_tokens_details": {
    "reasoning_tokens": 120
  }
}
}