# Razonamiento

> Águila y Apu piensan antes de responder. Cómo afecta a tus tokens y cómo controlarlo.

`aguila` y `apu` **razonan antes de responder**: piensan el problema y después escriben la respuesta. Eso mejora las tareas difíciles, pero tiene dos efectos que conviene conocer.

## El razonamiento se cobra como salida

Los tokens que el modelo usa para pensar **se cobran como tokens de salida**, aunque no los veas en la respuesta. Por eso `completion_tokens` en `usage` puede ser mayor que el texto que recibiste.

## No pongas un `max_tokens` muy bajo

El razonamiento sale del mismo presupuesto que `max_tokens`. Con un tope muy bajo, el modelo puede gastarlo entero pensando y devolverte **una respuesta vacía** con `finish_reason: "length"`.

**Nota**

Deja al menos **512** tokens para respuestas cortas. Si no pones nada, el valor por defecto es 32000.

## Controlar cuánto piensa

Con `reasoning.effort` eliges cuánto razona: `"low"`, `"medium"` o `"high"`.

```json
{
  "model": "aguila",
  "messages": [{"role": "user", "content": "Planifica la migración de mi base de datos"}],
  "reasoning": {"effort": "low"}
}
```

- **`low`**: más rápido y más barato. Suficiente para preguntas directas.
- **`high`**: para problemas de varios pasos, código difícil o análisis largos.

Si no lo mandas, el modelo decide.
