API de Claude Sonnet 5.5
API de Claude Sonnet 5.5: razonamiento adaptativo o entre herramientas, límites, streaming y precios de entrada, salida y caché por grupo.
Esta referencia presenta Claude Sonnet 5.5 y sus parámetros específicos de Messages. Usa claude-sonnet-5-5 con POST https://api.wanapi.app/v1/messages. Compara los modelos Claude.
Configuración del modelo
| Ajuste | Claude Sonnet 5.5 |
|---|---|
| ID del modelo | claude-sonnet-5-5 |
| Ventana de contexto | 1M tokens |
| Salida síncrona máxima | 128000 tokens, incluido el razonamiento |
| Modos de razonamiento | Adaptativo o between_tools |
| Esfuerzo predeterminado | high |
Llamadas forzadas a herramientas (any / tool) | No admitidas |
Conexión y primera solicitud
Crea una clave en la configuración de claves de API. Una sola clave de API sirve para todos los modelos y grupos. Guárdala en el entorno de tu servidor como WAN_API_KEY. Envía anthropic-version: 2023-06-01; añade anthropic-beta solo para las funciones que lo requieran.
curl https://api.wanapi.app/v1/messages \
-H "x-api-key: $WAN_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Explain the purpose of a database index in three sentences."}]
}'import os
import anthropic
client = anthropic.Anthropic(
api_key=os.environ["WAN_API_KEY"],
base_url="https://api.wanapi.app",
)
message = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Explain the purpose of a database index in three sentences."}],
)
print("".join(block.text for block in message.content if block.type == "text"))Compatibilidad actual de la API
La tabla siguiente describe el contrato nativo de este modelo. Wan API reenvía actualmente las solicitudes a través de una capa de compatibilidad. Usa un valor positivo de max_tokens: la pasarela sustituye actualmente 0 por un límite de generación, por lo que aquí no sirve para precargar únicamente la caché.
La pasarela actual no reenvía diagnostics, compaction, fallbacks, fallback_credit_token ni thread. La configuración actual del canal también filtra speed, service_tier e inference_geo. Estos campos se documentan a continuación para explicar el contrato del modelo, pero aún no están disponibles a través de esta conexión. Una respuesta correcta no significa que un campo ignorado haya surtido efecto. Las funciones beta que necesitan estos campos tienen la misma limitación.
Parámetros
| Parámetro | Tipo / obligatoriedad | Restricciones y valores predeterminados oficiales |
|---|---|---|
model | Cadena, obligatorio | claude-sonnet-5-5. |
max_tokens | Entero, obligatorio | 0–128000, incluidos los tokens de razonamiento. Oficialmente, 0 llena la caché del prompt sin generar salida; consulta la sección de compatibilidad actual de la API. |
messages | Array de objetos, obligatorio | Al menos un mensaje de conversación y como máximo 100000. Cada uno tiene role y content; el contenido es una cadena o un array de bloques. Los turnos normales usan user/assistant. Los mensajes system intermedios siguen las reglas oficiales de ubicación. |
system | Cadena o array de bloques de texto | Instrucciones de nivel superior. Los bloques de texto pueden incluir puntos de caché. |
thinking | Objeto | Predeterminado: {"type":"adaptive"}. El otro modo admitido es {"type":"between_tools"}. Se rechazan los presupuestos manuales y disabled. |
thinking.display | Enum | Solo en modo adaptativo: omitted (predeterminado) o summarized. Omitir el resumen no significa desactivar el razonamiento. |
thinking.block_binding | Objeto, beta | Solo en modo adaptativo. Requiere thinking-binding-controls-2026-08-01; sigue el contrato oficial de conservación del razonamiento. |
output_config.effort | Enum o null | low, medium, high, xhigh, max; predeterminado: high. Null mantiene el valor predeterminado. |
output_config.format | Objeto o null | Salida JSON estructurada: {"type":"json_schema","schema":{...}}. Usa el subconjunto admitido de JSON Schema. |
stream | Booleano | Predeterminado: false; true devuelve eventos SSE. |
stop_sequences | Array de cadenas | Oficialmente, detiene la generación al encontrar una cadena coincidente. La comprobación de compatibilidad del proveedor no hizo efectivo este comportamiento. |
temperature | Número o null | Solo se acepta 1 por compatibilidad; omítelo. Se rechazan los demás valores no nulos. |
top_p | Número o null | Solo se acepta 0.99–1 por compatibilidad; omítelo. |
top_k | Ningún valor no nulo | El muestreo no está admitido; omite esta propiedad. |
tools | Array de objetos | Las herramientas del cliente tienen name, input_schema y ajustes opcionales de descripción y validación estricta. Las herramientas del servidor usan sus definiciones oficiales versionadas. |
tool_choice | Objeto | auto (predeterminado) o none. Se rechazan any y tool forzado con nombre. auto puede incluir disable_parallel_tool_use. |
metadata.user_id | Cadena o null | Hasta 512 caracteres; usa un identificador opaco. |
cache_control | Objeto o null | type: "ephemeral"; ttl: "5m" (predeterminado) o "1h". Sonnet 5.5 requiere al menos 512 tokens que puedan almacenarse en caché. La API oficial también admite puntos de caché a nivel de bloque. |
diagnostics | Objeto o null | previous_message_id: cadena de hasta 256 caracteres o null. Solicita diagnósticos de divergencia de caché. |
service_tier | Enum | auto (predeterminado) o standard_only. |
speed | Enum o null | Omítelo o usa standard / null. Sonnet 5.5 no admite fast. |
inference_geo | Cadena o null | El valor predeterminado oficial procede de la configuración de la cuenta. Que se acepte una solicitud no confirma dónde se procesa. |
fallbacks | Cadena, array de objetos o null, beta | "default" o hasta tres entradas alternativas. Cada una requiere model; las opciones que pueden sobrescribirse son max_tokens, thinking, output_config y speed. Consulta las reglas de modelos alternativos más abajo. |
fallback_credit_token | Cadena, objeto o null | Un token de un rechazo anterior o {"token":"...","mode":"strict"}. La forma de objeto requiere fallback-credit-2026-07-01; mode es strict (predeterminado) o best_effort. No puede combinarse con un valor no nulo de fallbacks. |
container | Cadena, objeto o null | ID del contenedor o configuración con id y skills opcionales (hasta 20). Las skills usan los campos oficiales de tipo, identificador y versión. |
context_management | Objeto o null | Configuración oficial de edición del contexto, incluido edits; null omite el ajuste. Siguen aplicándose las restricciones de edición de cada modelo. |
mcp_servers | Array de objetos | Definiciones oficiales de servidores MCP, sujetas a la versión beta y la autenticación del servidor requeridas. Una prueba con un array vacío no verifica la ejecución remota de MCP. |
compaction | Objeto o null, beta | {"type":"summarize"}, con compact-2026-09-04; null omite la compactación. No puede activarse junto con context_management no nulo, secuencias de parada o formato de salida estructurada. La compactación firmada no superó la prueba actual. |
messages[].output_config.effort | Enum, beta | Esfuerzo por mensaje en un mensaje del sistema; requiere mid-conversation-output-config-2026-07-01. Los mensajes del sistema que solo definen el esfuerzo pueden aparecer en cualquier posición; los grupos del sistema con contenido siguen las reglas oficiales de ubicación. No debe cambiar el esfuerzo en modo between_tools. |
Razonamiento y herramientas
between_tools solo admite su propiedad type y esfuerzo low, medium o high. No envíes display, budget_tokens ni block_binding con este modo. Ejemplo:
{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"thinking": {"type": "between_tools"},
"output_config": {"effort": "medium"},
"messages": [{"role": "user", "content": "Explain this concept briefly."}]
}No se admite el prellenado de respuestas del asistente. Para continuar un pause_turn, vuelve a enviar sin cambios el contenido del asistente devuelto por la herramienta del servidor. La compactación resume el historial existente; no es un prellenado del asistente. Conserva exactamente los bloques de razonamiento y las firmas; no los transfieras entre modelos ni edites el historial anterior sin seguir las reglas oficiales de vinculación.
En la API nativa de Claude, el uso del ordenador requiere computer_toolset_20260801; se rechaza computer_20251124. Para este ejecutor también se rechazan las configuraciones de asesor que usan claude-opus-4-8, claude-opus-4-7 o claude-sonnet-5.
Entrada multimedia
Para imágenes y PDF, usa URL HTTP(S) de acceso público en los bloques content de un mensaje del usuario. Debes alojar tus propios archivos; esta integración no ofrece una API de archivos ni permite subirlos. Ejemplo de entrada de imagen:
{"role":"user","content":[
{"type":"image","source":{"type":"url","url":"https://example.com/chart.png"}},
{"type":"text","text":"What does this chart show?"}
]}Usa un bloque document para un PDF. Al continuar una conversación, conserva sin cambios los IDs de uso de herramientas, los bloques completos de razonamiento y las firmas. Tu aplicación ejecuta las herramientas del cliente y devuelve sus resultados; declarar una herramienta no la ejecuta.
Precios
USD por 1 millón de tokens
Las tarifas actuales incluyen el multiplicador de cada grupo. Los precios se guardan en caché hasta 2 minutos.
Una sola clave de API sirve para todos los modelos y grupos. Predeterminado señala el primer grupo apto según el orden de enrutamiento automático; la solicitud se factura con las tarifas del grupo seleccionado.
Claude Sonnet 5.5
claude-sonnet-5-5
| Tokens facturables | claude · Predeterminado |
|---|---|
| Todas las longitudes de entrada | |
| Entrada (sin caché) | 1 US$ |
| Salida | 5 US$ |
| Lectura de caché | 0,05 US$ |
| Escritura en caché · 5 minutos | 1,25 US$ |
| Escritura en caché · 1 hora | 2 US$ |
— indica que no hay una tarifa verificada disponible; no significa que sea gratis.
Las tarifas de caché solo se aplican cuando la respuesta indica el uso de caché correspondiente. No vuelvas a contar los tokens en caché como entrada sin caché.
Multiplica el número de tokens facturables de cada categoría por su tarifa y divide el total entre 1.000.000. Los tokens de razonamiento están incluidos en los tokens de salida; no se cobran una segunda vez. Las lecturas de caché, las escrituras de 5 minutos y las de 1 hora tienen tarifas distintas. Si el precio depende de la longitud, elige el tramo aplicable antes de calcular el coste de la solicitud.
Respuesta y streaming
Un mensaje completado incluye id, type, role, model, content, stop_reason y usage. Lee los bloques de texto de content; el primer bloque puede ser de razonamiento o una llamada a una herramienta. Este ejemplo es ilustrativo:
{
"id": "msg_example",
"type": "message",
"role": "assistant",
"model": "claude-sonnet-5-5",
"content": [{"type": "text", "text": "A database index helps locate rows without scanning the whole table."}],
"stop_reason": "end_turn",
"usage": {"input_tokens": 24, "output_tokens": 18}
}Establece stream: true para usar SSE y añade curl -N. Procesa message_start, content_block_start, content_block_delta, content_block_stop, message_delta y message_stop, además de ping y los errores del flujo. Lee el uso final; no trates cada fragmento como una respuesta completa.
Formatos compatibles con OpenAI
El mismo ID de modelo funciona con POST /v1/chat/completions y POST /v1/responses. Usa Authorization: Bearer YOUR_API_KEY y la URL base https://api.wanapi.app/v1 en el SDK de OpenAI. Chat Completions usa messages; Responses usa input. Sus campos se convierten a Messages, por lo que debes usar /v1/messages para los parámetros nativos documentados arriba.
curl https://api.wanapi.app/v1/chat/completions \
-H "Authorization: Bearer $WAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"claude-sonnet-5-5","max_tokens":256,"messages":[{"role":"user","content":"Reply with OK."}]}'Registros de uso y errores
Los registros de LLM muestran las llamadas completadas en los últimos 7 días, con el modelo, los tokens de entrada y salida y el coste. Actualiza la página después de una llamada y filtra por claude-sonnet-5-5. Usa los registros de tareas para imágenes y vídeos.
Si una solicitud falla, consulta el estado HTTP y el objeto error. Comprueba la clave, el saldo, el ID del modelo y las combinaciones de parámetros admitidas. Un rechazo del modelo o una parada por límite de salida no es lo mismo que un error HTTP. Si se interrumpe una solicitud o un flujo, consulta los registros antes de reintentarlo: una nueva solicitud puede generar otro cargo.