API de Claude Haiku 5.5
API de Claude Haiku 5.5: razonamiento adaptativo o desactivado, herramientas forzadas, parámetros, streaming y precios por grupo.
Esta referencia presenta Claude Haiku 5.5 y sus parámetros específicos de Messages. Usa claude-haiku-5-5 con POST https://api.wanapi.app/v1/messages. Compara los modelos Claude.
Configuración del modelo
| Ajuste | Claude Haiku 5.5 |
|---|---|
| ID del modelo | claude-haiku-5-5 |
| Salida síncrona máxima | 128000 tokens, incluido el razonamiento |
| Modos de razonamiento | Adaptativo o desactivado |
| Esfuerzo predeterminado | medium |
Llamadas forzadas a herramientas (any / tool) | 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-haiku-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-haiku-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
| Campo | Obligatorio | Contrato |
|---|---|---|
model | Sí | claude-haiku-5-5. |
max_tokens | Sí | Entero entre 0 y 128000, incluido el razonamiento. Sin valor predeterminado en la API. |
messages | Sí | 1–100000 mensajes con un rol y una cadena o un array de bloques de contenido. Consulta las reglas de conversación más abajo. |
system | No | Cadena o array de bloques de texto. No admite null. |
thinking | No | Adaptativo por defecto, o desactivado. Sin presupuesto manual ni modo entre herramientas. |
output_config | No | Objeto con effort, format y el campo beta opcional task_budget. |
stop_sequences | No | Array de cadenas de parada. |
stream | No | Booleano; false por defecto. |
temperature | No | Omítelo. Se descarta aquí; el valor oficial de compatibilidad es 1. |
top_p | No | Omítelo. Se descarta aquí; el valor oficial de compatibilidad es 0.99. |
top_k | No | No admitido; se descarta. |
tools | No | Array de herramientas del cliente o declaraciones oficiales de herramientas del servidor. |
tool_choice | No | auto, none, any o tool con nombre. Se permiten llamadas forzadas a herramientas. |
metadata | No | Objeto; el campo opcional user_id es una cadena de hasta 512 caracteres o null. |
cache_control | No | Null o {"type":"ephemeral","ttl":"5m"}; TTL también admite 1h. El TTL predeterminado es 5m. |
container | No | Null, cadena con el ID del contenedor u objeto con ID opcional y hasta 20 skills. |
context_management | No | Null u objeto con ediciones oficiales del contexto; se aplican las cabeceras beta. |
mcp_servers | No | Array de hasta 20 servidores URL; requiere la cabecera beta MCP correspondiente. |
service_tier | No | auto o standard_only. Haiku no tiene capacidad Priority Tier. |
inference_geo | No | global, us o null. Si se omite, se usa el valor predeterminado de la cuenta; consulta el uso informado antes de dar por hecho una región. |
diagnostics | No | Null u objeto; previous_message_id es null o una cadena de hasta 256 caracteres. |
compaction | No | Null o {"type":"summarize","instructions":"..."}. Las instrucciones son opcionales, admiten null y tienen un máximo de 16384 caracteres. |
fallbacks | No | Null o default con la beta correspondiente. Haiku no tiene modelos alternativos automáticos; las listas explícitas no son válidas. |
fallback_credit_token | No | Null, una cadena de token o {token,mode}. La API debe comprobar la elegibilidad y la validez; no des por hecho que cualquier modelo es un destino apto. |
speed | No | standard o null. El modo rápido no está admitido. |
Razonamiento y herramientas
El valor predeterminado es razonamiento adaptativo con esfuerzo medium y sin texto de razonamiento. El esfuerzo admite low, medium, high, xhigh, max o null para usar el valor predeterminado.
{
"thinking": {"type": "adaptive", "display": "summarized"},
"output_config": {"effort": "medium"}
}Para desactivar el razonamiento, usa {"type":"disabled"} con esfuerzo low, medium o high. No incluyas display ni block_binding en el modo desactivado. No son válidos enabled, budget_tokens, between_tools ni el razonamiento desactivado con xhigh/max.
En modo adaptativo, display admite omitted, summarized o null. El valor beta genérico updates requiere thinking-display-updates-2026-08-18; Anthropic no establece actualmente actualizaciones de progreso legibles para Haiku, por lo que no debes depender de esa salida.
El campo opcional thinking.block_binding requiere thinking-binding-controls-2026-08-01. Es null o un objeto cuyo prefix_mismatch_behavior es error, drop_block o null. Al volver a enviar el historial, conserva sin cambios los turnos anteriores y los bloques completos de razonamiento. Las firmas de razonamiento están vinculadas a la cuenta que las generó o a una cuenta asociada.
output_config.task_budget es null o { "type": "tokens", "total": 20000 }, con remaining opcional de tipo entero o null. Requiere task-budgets-2026-03-13; total debe ser al menos 20000. Aquí no se impone ningún intervalo adicional para remaining.
Herramientas y salida estructurada
Las herramientas del cliente requieren un nombre de 1–128 letras, dígitos, guiones bajos o guiones y un input_schema con type: "object". Usa tool_choice: {"type":"any"} o {"type":"tool","name":"lookup"} para forzar una herramienta declarada. Con razonamiento adaptativo, la respuesta de una herramienta forzada comienza con la llamada a la herramienta, sin bloque de razonamiento.
disable_parallel_tool_use es un booleano opcional para las opciones auto, any y tool; no es un campo de none. Devuelve el resultado de la herramienta con el tool_use_id original. Tu aplicación ejecuta las herramientas del cliente.
{
"tools": [{
"name": "lookup",
"description": "Look up a product by SKU.",
"input_schema": {
"type": "object",
"properties": {"sku": {"type": "string"}},
"required": ["sku"],
"additionalProperties": false
}
}],
"tool_choice": {"type": "tool", "name": "lookup"}
}Las respuestas estructuradas usan output_config.format: {"type":"json_schema","schema":{...}}. Sigue el subconjunto de JSON Schema admitido por Anthropic, incluido additionalProperties: false en los objetos. Una estructura válida no garantiza valores correctos. Las herramientas estrictas y la salida estructurada tienen límites para el esquema completo; consulta la referencia oficial de salida estructurada.
El uso del ordenador requiere computer_toolset_20260801; las versiones anteriores de la herramienta de ordenador no son válidas. El uso del navegador tiene su propio browser_toolset_20260801. Declarar una herramienta no verifica que funcione una sesión completa de herramientas del servidor. Consulta la guía oficial y los requisitos beta de la herramienta antes de usarla.
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 Haiku 5.5
claude-haiku-5-5
| Tokens facturables | claude · Predeterminado | |
|---|---|---|
| ≤ 100.000 tokens de entrada | > 100.000 tokens de entrada | |
| Entrada (sin caché) | 0,05 US$ | 0,25 US$ |
| Salida | 0,25 US$ | 1,25 US$ |
| Lectura de caché | 0,005 US$ | 0,025 US$ |
| Escritura en caché · 5 minutos | 0,0625 US$ | 0,3125 US$ |
| Escritura en caché · 1 hora | 0,1 US$ | 0,5 US$ |
El umbral cuenta: Tokens de entrada sin caché. El tramo seleccionado se aplica a toda la solicitud, no solo a los tokens que superan el umbral.
— 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-haiku-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-haiku-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-haiku-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.
Referencias del modelo
API de Claude
Usa Claude con Anthropic Messages u OpenAI Chat Completions. IDs, ejemplos de streaming y precios de entrada, salida y caché por grupo.
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.