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





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

## Configuración del modelo [#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 [#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-sonnet-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-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 [#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]

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

```json
{
  "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 [#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 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 [#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-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 [#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-sonnet-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-sonnet-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 oficial de Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/overview)
* [Cambios y restricciones de Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/whats-new-sonnet-5-5)
* [Referencia de parámetros de Messages](https://platform.claude.com/docs/en/api/messages/create)
* [Esfuerzo por mensaje](https://platform.claude.com/docs/en/build-with-claude/effort)
* [Compactación bajo demanda](https://platform.claude.com/docs/en/build-with-claude/compaction-on-demand)
* [Rechazos y modelos alternativos](https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback)
* [Crédito para modelos alternativos](https://platform.claude.com/docs/en/build-with-claude/fallback-credit)
