# API de Claude Haiku 5.5 (https://wanapi.app/es/docs/claude-haiku-5-5)





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](/es/docs/claude-api).

## Configuración del modelo [#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 [#conexión-y-primera-solicitud]

Crea una clave en la [configuración de claves de API](/es/settings/apikeys). 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.

```bash
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."}]
  }'
```

```python
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 [#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. &#x2A;*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á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 [#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.

```json
{
  "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 [#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.

```json
{
  "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](https://platform.claude.com/docs/en/build-with-claude/structured-outputs).

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 [#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:

```json
{"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 [#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 | claude · Predeterminado · > 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 [#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:

```json
{
  "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 [#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.

```bash
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 [#registros-de-uso-y-errores]

Los [registros de LLM](/es/usage) 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](/es/tasks) para imágenes y vídeos.

Si una solicitud falla, consulta el estado HTTP y el objeto `error`. Comprueba la clave, el [saldo](/es/docs/balance), 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 [#referencias-del-modelo]

* [Descripción general de Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/overview)
* [Guía de migración a Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/migration-guide)
* [Referencia de Messages](https://platform.claude.com/docs/en/api/messages/create)
* [Referencia de Messages beta](https://platform.claude.com/docs/en/api/beta/messages/create)
* [Razonamiento](https://platform.claude.com/docs/en/build-with-claude/thinking), [esfuerzo](https://platform.claude.com/docs/en/build-with-claude/effort), [presupuestos de tareas](https://platform.claude.com/docs/en/build-with-claude/task-budgets)
* [Compactación bajo demanda](https://platform.claude.com/docs/en/build-with-claude/compaction-on-demand), [Edición del contexto](https://platform.claude.com/docs/en/build-with-claude/context-editing)
* [Caché de prompts](https://platform.claude.com/docs/en/build-with-claude/prompt-caching), [Visión](https://platform.claude.com/docs/en/build-with-claude/vision), [Compatibilidad con PDF](https://platform.claude.com/docs/en/build-with-claude/pdf-support)
