Parameters by Upstream
Some request fields do not mean the same thing everywhere. This page states what the gateway does with each one on the way to each provider - passed through, translated into the provider's own equivalent, or dropped.
This is not a list of every accepted field; each endpoint page documents its own request body. Listed here are the fields where supported is not a yes or no, because the answer changes with the provider your model runs on.
reasoning_effort
Full guide, with values and cost impact →
| You call | Upstream | Behaviour | Descrição |
|---|---|---|---|
/v1/chat/completions | OpenAI-compatible (GPT, GLM, DeepSeek, Qwen, Kimi…) | repassado | Forwarded to the provider as sent, with one exception: when a model's catalog entry lists the effort levels it accepts, a value below the lowest is raised to it and one above the highest steps down (GPT-6.1 Sol cannot turn reasoning off, so none and minimal run at low). Otherwise the gateway neither validates the value nor guarantees the provider honours it. Commonly minimal, low, medium and high, but the accepted set is the provider's: OpenAI also takes none on most models, GLM takes up to max. Check the provider's own reference for its range. |
/v1/chat/completions | Google Vertex - Gemini 4 | convertido | Becomes Gemini's thinkingLevel, kept inside the three levels Gemini 4 Argon accepts: none and minimal run at low (the model cannot turn thinking off), low/medium/high map straight across, xhigh and max run at high. An explicit google.thinking_config in the request wins over this mapping. |
/v1/chat/completions | Google Vertex - Gemini 3.x | convertido | Becomes Gemini's thinkingLevel: none and minimal both map to minimal, low/medium/high map straight across. An explicit google.thinking_config in the request wins over this mapping. |
/v1/chat/completions | Google Vertex - Gemini 2.5 | descartado | Gemini 2.5 only understands thinkingBudget and rejects thinkingLevel outright, so the gateway sends neither and leaves the model at its default thinking behaviour. Use google.thinking_config with thinking_budget to control 2.5. |
/v1/chat/completions | Anthropic (Claude) | convertido | Torna-se o thinking da Anthropic, na forma que o modelo aceita. Nos modelos Claude que só aceitam raciocínio adaptativo (Claude Opus 4.7 e posteriores, Sonnet 5 e posteriores, Haiku 5.5), low/medium/high/xhigh/max passam a thinking:{"type":"adaptive"} com output_config.effort no mesmo nível, e minimal corre como low. none desliga o raciocínio na forma própria do modelo: {"type":"disabled"} na maioria, {"type":"between_tools"} no Sonnet 5.5, e adaptativo em low no Opus 5.5, que não consegue desligar o raciocínio. Qualquer outro valor não é encaminhado. Nos modelos Claude anteriores torna-se um orçamento: none e minimal desligam o raciocínio ({"type":"disabled"}); low/medium/high/xhigh/max passam a um orçamento de 2,048 / 8,192 / 16,384 / 32,768 tokens, o inverso da divisão usada no outro sentido. Um orçamento derivado é mantido abaixo de max_tokens e não é enviado de todo quando max_tokens não comporta o mínimo de 1,024 tokens da Anthropic, por isso pedir um nível de esforço nunca transforma um pedido que funciona num erro 400 do fornecedor. |
/v1/messages | OpenAI-compatible (GPT, GLM, DeepSeek, Qwen, Kimi…) | convertido | Derived from thinking.budget_tokens by bucket, when extended thinking is enabled and the budget is above zero: up to 2,048 tokens becomes low, up to 8,192 becomes medium, above that becomes high. A zero or absent budget sends nothing. For a model whose catalog entry lists the effort levels it accepts (GPT-6.1 Sol), the request's intent is followed instead: thinking disabled or between_tools runs at the lowest level (low), even when output_config.effort is also set; otherwise output_config.effort is sent as the effort. |
/v1/responses | OpenAI-compatible (GPT, GLM, DeepSeek, Qwen, Kimi…) | convertido | Read out of the Responses-API reasoning.effort object and sent as the flat reasoning_effort field. |
thinking / thinking_budget / enable_thinking
| You call | Upstream | Behaviour | Descrição |
|---|---|---|---|
/v1/chat/completions | Anthropic (Claude) | convertido | São os nomes que outros fornecedores dão ao mesmo controlo, e o gateway normaliza-os. thinking:{"type":"disabled"}, enable_thinking:false e thinking_budget:0 desligam o raciocínio, tal como reasoning_effort none nesse modelo. Nos modelos Claude anteriores, thinking_budget:N e thinking:{"type":"enabled","budget_tokens":N} passam o orçamento sem alterações; um valor fora do intervalo é recusado pelo fornecedor em vez de ajustado em silêncio. Nos modelos que só aceitam raciocínio adaptativo nunca é enviado um orçamento: torna-se output_config.effort (até 2,048 low, até 8,192 medium, abaixo de 32,768 high, a partir de 32,768 xhigh; nunca max). thinking:{"type":"adaptive"} sozinho não envia nenhuma definição de raciocínio, e o modelo corre com o comportamento predefinido. |
/v1/chat/completions | Google Vertex - Gemini 4 | convertido | Normalised into thinkingConfig.thinkingLevel, because Gemini 4 Argon rejects thinkingBudget: turning thinking off runs at low, and an explicit budget is folded into a level (up to 2,048 tokens low, up to 8,192 medium, above that high). An explicit google.thinking_config in the request still wins. |
/v1/chat/completions | Google Vertex - Gemini 3.x | convertido | Normalised into thinkingConfig: turning thinking off becomes thinkingLevel:"minimal", and an explicit budget becomes thinkingBudget. An explicit google.thinking_config in the request still wins over all of it. |
/v1/chat/completions | Google Vertex - Gemini 2.5 | convertido | Normalised into thinkingConfig.thinkingBudget - turning thinking off sends a budget of 0, and an explicit budget passes through. thinkingLevel is not used here because 2.5 rejects it. An explicit google.thinking_config in the request still wins. |
Every row is transcribed from the converter that implements it and pinned by a Go test, so this table cannot drift from the running gateway without a build failing.