Modo de razonamiento
Los modelos compatibles permiten ajustar la intensidad con reasoning_effort o su parámetro equivalente. Los niveles varían por modelo; una intensidad mayor suele aumentar latencia y tokens facturados.
- Comprueba en el catálogo si el modelo admite razonamiento y cuáles son sus nombres oficiales.
- No supongas que todos aceptan low, medium y high; omite el parámetro cuando no exista.
- Empieza por el nivel más bajo suficiente y compara usage, tiempo y calidad.
Ejemplos completos
A continuación se conservan todos los ejemplos ejecutables de la guía original. Ejecuta únicamente los bloques que correspondan a tu herramienta y sistema operativo.
json
"usage": {
"prompt_tokens": 179,
"completion_tokens": 545, // total output — this is what's billed
"completion_tokens_details": {
"reasoning_tokens": 445 // of which, spent on reasoning
}
}bash
curl https://nordrouter.com/v1/chat/completions \
-H "Authorization: Bearer sk-nr-YOUR-KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "anthropic/claude-sonnet-5",
"max_tokens": 4000,
"reasoning": { "effort": "high" },
"messages": [{ "role": "user", "content": "A hard problem…" }]
}'Documentación oficial y enlaces
| Parameter | What it does |
|---|---|
reasoning.effort | Reasoning depth: "low" / "medium" / "high". Lower effort — fewer reasoning tokens, cheaper responses |
reasoning.max_tokens | Token budget for reasoning (Anthropic style). Must be lower than the request's max_tokens |
reasoning.enabled: false | Turn reasoning off (where the model supports it) |
reasoning.exclude: true | Hide the reasoning text from the response. Does not save money — the model still thinks and the tokens are billed |
| Model | Behavior |
|---|---|
anthropic/claude-sonnet-5 | Doesn't reason by default. effort and max_tokens enable thinking, enabled: false genuinely disables it |
anthropic/claude-fable-5 | Thinks adaptively — decides on its own how much. reasoning.* parameters are not supported (returns 400); control depth with output_config: { "effort": "low" | "medium" | "high" } |
openai/gpt-5.4, gpt-5.5 | Reason by default; reasoning_effort scales the depth |
x-ai/grok-4.3 | Reasons by default and generously (hundreds of tokens); effort: "low" cuts it down noticeably |
deepseek/deepseek-r1, z-ai/glm-5.x | Always think: "disabling" only hides the text, reasoning tokens are still billed |
Guías relacionadas
Comprueba primero la conexión con una solicitud de texto mínima. Después añade streaming, herramientas, imágenes u otras funciones avanzadas. Nunca incluyas la clave API en código público ni en un frontend del navegador.