API 参考/请求处理

协议转换与参数处理

网关会把请求转换成模型的原生格式,并去掉模型不接受或不生效的参数。所以同一个请求,直接发到官方接口可能返回 400,经 Wokey 调用会返回 200。本页按接口和模型说明这些处理。

本页内容expand_more

处理原则link

  • 网关会删除或裁剪两类字段:目标模型一定会拒绝的,以及对目标模型不生效的。删除后请求照常发给上游。所以同一个请求,直接发到官方接口可能返回 400,经 Wokey 调用会返回 200。例如 Claude Sonnet 5.5 带 temperature: 0.5,官方返回 400,经 Wokey 时 temperature 被去掉,请求正常完成。
  • 无法等价转换的写法不做改写,请求原样发给上游,由上游返回 400。例如 Claude Sonnet 5.5 的 tool_choice 取 any 或 tool。
  • 下面按模型列出常见的参数处理。不同模型的规则会随上游变化而调整。

想确认响应确实来自官方接口,可以为 Key 打开「官方直连验证」。 了解可验证 API →

采样参数link

当前的推理模型大多自己决定采样,不接受或会拒绝 temperature 等参数。下表是各模型的处理方式。

模型处理方式
Claude Opus 4.6、Sonnet 4.6、Sonnet 4.5、Haiku 4.5temperature 转发,限制在 0–1。top_p、top_k 不转发。
其他 Claude 模型temperature、top_p、top_k 都不转发。
GPTtemperature 不转发。从 Chat Completions 或 Messages 调用时,top_p 也不转发。GPT-6 Astra、GPT-6.1 Sol 无论从哪个接口调用,都不转发 top_p、logprobs、top_logprobs。
Grok用 Chat Completions 调用时,采样参数原样转发;Grok 4.3、4.5、4.6、4.7 不转发 stop、presence_penalty、frequency_penalty。用 Responses 或 Messages 调用时,temperature、top_p 不转发。
Kimi K3、K3.1 Pro网关先校验:temperature 须在 0–1,top_p 只能是 0.95,presence_penalty、frequency_penalty 只能是 0,n 只能是 1,不符合时返回 400。校验通过后,temperature、top_p、presence_penalty 不转发。
其他模型temperature 通常不转发,top_p 等其他参数照常转发。

思考与推理强度link

模型不接受的思考设置会被改写或去掉。去掉后按模型默认的自适应思考运行。

模型处理方式
Claude Sonnet 5.5thinking: {"type": "disabled"} 在 effort 为 low、medium、high 或未传时改成 between_tools,在 xhigh、max 时去掉。enabled 和手动 budget_tokens 去掉。
Claude Haiku 5.5disabled 在 effort 为 low、medium、high 或未传时保留,在 xhigh、max 时去掉。enabled 和手动 budget_tokens 去掉。
Claude Opus 5.5、Fable 5 系列只接受 adaptive,其他 thinking 写法去掉。
Claude Opus 5effort 为 xhigh、max 时,去掉 disabled。
GPT-6 Astra、GPT-6.1 Sol、GPT-5.3-Codexeffort 取 none 或 minimal 时提升为 low。
DeepSeek用 Responses 接口强制调用工具时(tool_choice 为 required 或指定某个工具),关闭思考(reasoning.effort: none)。上游不支持在思考模式下强制调用工具。

输出长度link

  • Claude:用 Chat Completions 或 Responses 调用时,不传输出上限按 4096。用 Messages 调用时 max_tokens 必填,缺少时网关直接返回 400,不发给上游。
  • Gemini:不传时按 65536。
  • GPT:max_tokens、max_output_tokens 不转发,由上游决定。

其他处理link

  • 从 Chat Completions 调 Claude 时,reasoning_effort 不生效,Claude 按模型默认的思考方式运行。
  • 从 Chat Completions 或 Messages 调 GPT 时,不传推理强度按 medium。
  • 从 Chat Completions 调 Claude 或 GPT 时,response_format 不生效。
  • 从 Chat Completions 或 Responses 调 Claude 时,parallel_tool_calls 不生效。
  • provider:Wokey 的扩展字段,只用于选择供应商,不会发给上游。
  • metadata:不转发给上游。
  • Claude 的 speed(fast mode):不支持。网关不转发,请求按标准速度运行,响应里 usage.speed 为 standard。
  • GPT 的 user、safety_identifier:不转发。
  • Assistant 预填:部分 Claude 通道不支持以 assistant 消息结尾的请求。网关会把整段对话转成一条 user 消息,请模型从预填处接着写,不重复预填内容。这种情况下,多轮结构不会保留。