API 参考/请求处理
协议转换与参数处理
网关会把请求转换成模型的原生格式,并去掉模型不接受或不生效的参数。所以同一个请求,直接发到官方接口可能返回 400,经 Wokey 调用会返回 200。本页按接口和模型说明这些处理。
处理原则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.5 | temperature 转发,限制在 0–1。top_p、top_k 不转发。 |
| 其他 Claude 模型 | temperature、top_p、top_k 都不转发。 |
| GPT | temperature 不转发。从 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.5 | thinking: {"type": "disabled"} 在 effort 为 low、medium、high 或未传时改成 between_tools,在 xhigh、max 时去掉。enabled 和手动 budget_tokens 去掉。 |
| Claude Haiku 5.5 | disabled 在 effort 为 low、medium、high 或未传时保留,在 xhigh、max 时去掉。enabled 和手动 budget_tokens 去掉。 |
| Claude Opus 5.5、Fable 5 系列 | 只接受 adaptive,其他 thinking 写法去掉。 |
| Claude Opus 5 | effort 为 xhigh、max 时,去掉 disabled。 |
| GPT-6 Astra、GPT-6.1 Sol、GPT-5.3-Codex | effort 取 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 消息,请模型从预填处接着写,不重复预填内容。这种情况下,多轮结构不会保留。