Chat Completions

OpenAI 风格的 Chat Completions 接口用于发送一组消息并获得模型回复。请求地址保持 OpenAI 兼容形态，方便现有 SDK 或网关调用代码迁移。

请求地址

鉴权方式

使用 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

请求示例

传入 model 和 messages，并使用 Bearer Token 完成鉴权。

curl https://api.0xtoken.cn/v1/chat/completions \
-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",
  "messages": [
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "Hello!"}
  ]
}'

请求体示例

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

{
"model": "deepseek-v4-pro",
"messages": [
  {"role": "system", "content": "You are a helpful assistant."},
  {"role": "user", "content": "证明根号 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_tokens / max_completion_tokens 时，平台会根据 reasoning_effort（与 thinking 同义）的推理深度自动填充默认的输出 Token 上限。显式传入则以用户值为准，不再覆盖。

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

响应字段

响应示例

一个启用深度思考后的非流式响应，reasoning_content 为思考内容，reasoning_tokens 为思考消耗：

{
"id": "chatcmpl-1xtoken",
"object": "chat.completion",
"created": 1753305600,
"model": "deepseek-v4-pro",
"choices": [
  {
    "index": 0,
    "message": {
      "role": "assistant",
      "reasoning_content": "要证明根号 2 是无理数，使用反证法……",
      "content": "假设根号 2 是有理数，则可表示为最简分数 p/q……矛盾，故根号 2 为无理数。",
      "tool_calls": null
    },
    "finish_reason": "stop",
    "logprobs": null
  }
],
"usage": {
  "prompt_tokens": 24,
  "completion_tokens": 180,
  "total_tokens": 204,
  "prompt_tokens_details": {
    "cached_tokens": 8
  },
  "completion_tokens_details": {
    "reasoning_tokens": 120
  }
}
}