Guías de modelos y modalidades21 de octubre de 2026Flatkey Team

API de Claude Sonnet (2026): IDs de modelo, configuración, límites y código para Sonnet 5.5

Todo para llamar a Claude Sonnet 5.5 por API: IDs de modelo, claves, código funcional, effort y razonamiento, límites de tasa, costes y correcciones de migración.

API de Claude Sonnet (2026): IDs de modelo, configuración, límites y código para Sonnet 5.5

Para usar la API de Claude Sonnet, crea una clave de API de Anthropic y envía una solicitud a https://api.anthropic.com/v1/messages con el ID de modelo claude-sonnet-5-5, el modelo Sonnet actual, lanzado el 28 de septiembre de 2026. Tiene una ventana de contexto de 1M de tokens, hasta 128K tokens de salida, razonamiento adaptativo activado por defecto y cuesta 2 $ por millón de tokens de entrada y 10 $ por millón de tokens de salida según los precios oficiales de Anthropic, a 21 de octubre de 2026. Si migras código desde Sonnet 4.6 o anterior, cinco parámetros que antes funcionaban ahora devuelven un error 400; los detallamos más abajo.

Esta guía es para desarrolladores que construyen productos sobre Claude: qué ID de modelo Sonnet usar, cómo obtener una clave, código funcional en curl, Python y Node.js, límites de tasa por nivel y los cambios incompatibles que más complican las migraciones. Para un desglose completo de costes de todos los modelos Claude, consulta nuestra guía de precios de la API de Claude.

Modelos Claude Sonnet disponibles en la API

Modelo	ID de modelo en la API	Estado (21 oct 2026)	Contexto / salida máx.	Entrada / salida por 1M tokens	Lectura de caché
Claude Sonnet 5.5	`claude-sonnet-5-5`	Actual, lanzado el 28 sep 2026	1M / 128K	$2 / $10	$0.10
Claude Sonnet 5	`claude-sonnet-5`	Heredado (legacy)	ver documentación	$2 / $10	$0.20
Claude Sonnet 4.6	`claude-sonnet-4-6`	Heredado (legacy)	ver documentación	$3 / $15	$0.30
Claude Sonnet 4.5	`claude-sonnet-4-5-20250929`	Obsoleto, se retira el 30 nov 2026	ver documentación	$3 / $15	$0.30

Precios de la página de precios de Anthropic; estado de los modelos de la visión general de modelos y la página de obsolescencias; especificaciones de Sonnet 5.5 de la ficha de Sonnet 5.5, todo verificado el 21 de octubre de 2026.

Cuál usar: usa claude-sonnet-5-5 para proyectos nuevos. Cuesta lo mismo por token que Sonnet 5, pero la mitad en lecturas de caché (0,10 $ frente a 0,20 $ por millón), según la guía de migración. Frente a Sonnet 4.6 (3 $ / 15 $), Sonnet 5.5 es más barato por token, pero ojo con el tokenizador: Anthropic indica que Sonnet 5.5 genera aproximadamente un 30 % más de tokens que Sonnet 4.6 para el mismo texto, así que compara recuentos reales, no solo precios de lista. Quienes usan Sonnet 4.5 deben migrar antes de su retirada el 30 de noviembre de 2026.

Sonnet 5.5 de un vistazo

Especificación	Valor	Fuente
ID de modelo (Claude API, Google Cloud, Microsoft Foundry, Claude Platform on AWS)	`claude-sonnet-5-5`	Ficha
ID de modelo en Amazon Bedrock	`anthropic.claude-sonnet-5-5`	Ficha
Ventana de contexto	1M de tokens	Ficha
Salida máxima	128K tokens; 300K en la Batch API con la cabecera beta `output-300k-2026-03-24`	Ficha
Modalidades	Texto e imágenes de entrada, texto de salida	Ficha
Razonamiento	Adaptativo, activado por defecto; el ajuste mínimo es `between_tools`	Ficha
Effort por defecto	`high`	Ficha
Fecha de corte de conocimiento	Junio de 2026	Ficha
Retirada	No antes del 28 de septiembre de 2027	Ficha

Cómo obtener una clave de API de Claude Sonnet

Inicia sesión en la Claude Console y abre API keys.
Crea una clave, cópiala una sola vez y guárdala como ANTHROPIC_API_KEY en tu entorno o gestor de secretos.
Añade saldo o un método de pago. El nivel de uso (y los límites de tasa) sube con el gasto; consulta la sección de límites más abajo.

Una misma clave sirve para todos los modelos Claude, así que no existe una "clave de API de Sonnet" aparte. Si prefieres una sola clave para Claude, GPT, Gemini y DeepSeek, una API unificada como Flatkey emite una clave única para todos ellos (lo vemos al final).

Tu primera solicitud a Claude Sonnet 5.5

La solicitud siguiente sigue el ejemplo oficial de Anthropic en la guía de migración de Sonnet 5.5. Fija un nivel de effort y evita todos los parámetros que devuelven 400 en este modelo.

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 4096,
    "messages": [{"role": "user", "content": "Write a SQL query that finds churned customers in the last 30 days."}],
    "output_config": {"effort": "medium"}
  }'

Python, con el SDK oficial anthropic:

# pip install anthropic
import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY

response = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=4096,
    messages=[{"role": "user", "content": "Write a SQL query that finds churned customers in the last 30 days."}],
    output_config={"effort": "medium"},
)

print("stop_reason:", response.stop_reason)
for block in response.content:
    if block.type == "text":  # adaptive thinking may add thinking blocks first
        print(block.text)

Node.js con @anthropic-ai/sdk:

// npm install @anthropic-ai/sdk
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic(); // reads ANTHROPIC_API_KEY

const response = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 4096,
  messages: [{ role: "user", content: "Write a SQL query that finds churned customers in the last 30 days." }],
  output_config: { effort: "medium" },
});

const text = response.content.find((b) => b.type === "text");
console.log(response.stop_reason, text?.text);

Lee la respuesta por tipo de bloque. Con el razonamiento adaptativo activo, el primer bloque de contenido puede ser un bloque thinking, así que response.content[0].text no es seguro en Sonnet 5.5.

Effort y razonamiento en Sonnet 5.5

Sonnet 5.5 sustituye los presupuestos fijos de razonamiento por un ajuste effort dentro de output_config (documentación de effort). El valor por defecto es high. La guía de migración de Anthropic muestra los niveles low, medium, high, xhigh y max.

Quieres	Envía	Notas de la documentación de Anthropic
Comportamiento por defecto	nada, o `thinking: {"type": "adaptive"}`	El razonamiento adaptativo está activado por defecto
Respuestas más baratas y rápidas	`output_config: {"effort": "low"}` o `"medium"`	Menos effort implica menos tokens de salida
Sin razonamiento previo	`thinking: {"type": "between_tools"}`	Se acepta con `low`, `medium` y `high`; devuelve 400 con `xhigh` o `max`
Problemas más difíciles	`output_config: {"effort": "xhigh"}` o `"max"`	Usa razonamiento adaptativo, no `between_tools`

Sonnet 5.5 no acepta thinking: {"type": "disabled"}; between_tools es el ajuste mínimo (guía de migración).

Parámetros que ahora devuelven un error 400

Si actualizas desde Sonnet 4.6 o anterior, elimina estos parámetros. Los cinco figuran en la guía de migración de Sonnet 5.5 de Anthropic:

Parámetro antiguo	En Sonnet 5.5	Sustitúyelo por
`thinking: {"type": "enabled", "budget_tokens": N}`	Error 400	`output_config.effort`
`temperature`, `top_p`, `top_k`	Error 400	Instrucciones en el prompt; effort
Prefill del asistente (último mensaje de `assistant`)	Error 400	Salidas estructuradas o instrucciones de sistema
`tool_choice` forzado (`any` o una herramienta concreta)	Error 400	`auto` con instrucciones claras sobre herramientas
`thinking: {"type": "disabled"}`	Error 400	`thinking: {"type": "between_tools"}`

Revisa también max_tokens y tus estimaciones de coste por el aumento de aproximadamente un 30 % de tokens frente a Sonnet 4.6. Si tras la actualización aparecen errores de ID de modelo, nuestras guías sobre Claude: versión de modelo no encontrada y errores 400 de Anthropic cubren las causas habituales.

Límites de tasa de la API de Claude Sonnet

Anthropic publica los límites por nivel en su página de límites de tasa. Para Sonnet 5.5, a 21 de octubre de 2026:

Nivel	Solicitudes por minuto	Tokens de entrada por minuto	Tokens de salida por minuto
Start	1.000	2.000.000	400.000
Build	5.000	5.000.000	1.000.000
Scale	10.000	10.000.000	2.000.000

Sonnet 5, Sonnet 4.x y Haiku 5.5 comparten las mismas cifras por nivel. Anthropic señala que, en la mayoría de los modelos, los tokens de entrada leídos de caché no cuentan para el límite de tokens de entrada por minuto, lo que convierte el prompt caching en una herramienta tanto de coste como de límites.

Cuánto cuesta Sonnet 5.5 en la práctica

Precios oficiales a 21 de octubre de 2026, por 1M de tokens (precios):

Concepto	Precio
Entrada	$2.00
Salida	$10.00
Escritura en caché, 5 minutos	$2.50
Escritura en caché, 1 hora	$4.00
Lectura de caché	$0.10
Batch API entrada / salida	$1.00 / $5.00
Inferencia solo en EE. UU. (`inference_geo`)	1,1x todos los precios de tokens

Ejemplo práctico: un asistente de soporte que gestiona 50.000 solicitudes al mes, cada una con un prompt de sistema en caché de 3.000 tokens, 500 tokens de entrada nuevos y 400 de salida. Lecturas de caché: 150M tokens × 0,10 $ = 15 $. Entrada nueva: 25M × 2 $ = 50 $. Salida: 20M × 10 $ = 200 $. Total: unos 265 $ al mes, sin contar las escrituras puntuales en caché. La salida domina, por eso effort importa más que optimizar la entrada. Para comparaciones modelo a modelo, consulta precios de la API de Claude y enrutamiento de API Claude frente a GPT.

Usar Claude Sonnet con el SDK de OpenAI

Anthropic ofrece un endpoint compatible con OpenAI en https://api.anthropic.com/v1/, pero su página de compatibilidad con el SDK de OpenAI lo describe como pensado para pruebas y comparaciones, no para la mayoría de usos en producción: el parámetro strict de function calling se ignora, response_format se ignora y no admite prompt caching. En producción con Sonnet 5.5, usa la Messages API nativa mostrada arriba. Nuestro artículo sobre compatibilidad de la API de Claude con el SDK de OpenAI repasa las opciones en detalle.

Una sola clave para Sonnet y otros modelos: Flatkey

Si tu producto también llama a GPT, Gemini o DeepSeek, Flatkey te da una sola clave y un solo saldo prepago para todos. El 21 de octubre de 2026, la página del modelo Claude Sonnet 5.5 de Flatkey indicaba 1,60 $ de entrada / 8,00 $ de salida por 1M de tokens, un 20 % por debajo de los 2 $ / 10 $ de Anthropic, y Sonnet 4.6 a 2,40 $ / 12,00 $. El SDK de Anthropic funciona cambiando la base URL a https://router.flatkey.ai (sin /v1), según la guía del SDK de Anthropic de Flatkey:

import anthropic

client = anthropic.Anthropic(api_key="YOUR_FLATKEY_KEY", base_url="https://router.flatkey.ai")
msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Draft a release note for v2.3."}],
)
print(next(b.text for b in msg.content if b.type == "text"))

Para configurar Claude Code, consulta configuración del router de API para Claude Code. Usa Anthropic directamente si necesitas funciones o contratos que solo existen en su propia plataforma, como cabeceras beta concretas el día del lanzamiento o un acuerdo empresarial.

Preguntas frecuentes

¿Cuál es el nombre del modelo de la API de Claude Sonnet?

El ID actual es claude-sonnet-5-5 en Claude API, Google Cloud, Microsoft Foundry y Claude Platform on AWS, y anthropic.claude-sonnet-5-5 en Amazon Bedrock, a 21 de octubre de 2026. Entre los IDs anteriores están claude-sonnet-5 y claude-sonnet-4-6.

¿Cuánto cuesta la API de Claude Sonnet?

Claude Sonnet 5.5 cuesta 2 $ por millón de tokens de entrada y 10 $ por millón de tokens de salida, con lecturas de caché a 0,10 $ y la Batch API a mitad de precio (1 $ / 5 $), según la página de precios de Anthropic verificada el 21 de octubre de 2026.

¿La API de Claude Sonnet es gratuita?

No. La API de Anthropic se paga por token; no hay un nivel gratuito de API para Sonnet. Las apps de Claude para consumidores tienen sus propios planes gratuitos y de pago, independientes de la facturación de la API. Para opciones gratuitas de otros proveedores, consulta nuestra guía de APIs de LLM gratuitas.

¿Cuál es la ventana de contexto de Claude Sonnet 5.5?

1M de tokens, con hasta 128K tokens de salida por solicitud, o 300K en la Message Batches API con la cabecera beta output-300k-2026-03-24.

¿Por qué mi solicitud a Sonnet devuelve un error 400 tras actualizar?

Sonnet 5.5 rechaza los presupuestos de razonamiento, temperature/top_p/top_k, el prefill del asistente, la elección forzada de herramienta y thinking: {"type": "disabled"}. Elimínalos y usa output_config.effort o thinking: {"type": "between_tools"}.

¿Existe una API de Claude Sonnet 5?

Sí. claude-sonnet-5 sigue disponible como modelo heredado a 2 $ / 10 $ por millón de tokens, con lecturas de caché a 0,20 $. Sonnet 5.5 tiene el mismo precio por token y lecturas de caché a la mitad, por lo que es la mejor opción por defecto para proyectos nuevos.