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





Esta referencia presenta **Claude Opus 5.5** y sus parámetros específicos de Messages. Usa `claude-opus-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 Opus 5.5                         |
| ------------------------------------------------- | --------------------------------------- |
| ID del modelo                                     | `claude-opus-5-5`                       |
| Ventana de contexto                               | 1M tokens                               |
| Salida síncrona máxima                            | 128000 tokens, incluido el razonamiento |
| Modos de razonamiento                             | Adaptativo, siempre activo              |
| Esfuerzo predeterminado                           | `medium`                                |
| 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-opus-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-opus-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]

| Nombre                                                                                                    | Tipo               | Obligatorio | Predeterminado         | Notas                                                                                                                                                                                                                                                     |
| --------------------------------------------------------------------------------------------------------- | ------------------ | ----------- | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `model`                                                                                                   | Cadena             | Sí          | —                      | `claude-opus-5-5`.                                                                                                                                                                                                                                        |
| `max_tokens`                                                                                              | Entero             | Sí          | —                      | 0–128000. Incluye los tokens de razonamiento. `0` solo precarga la caché del prompt.                                                                                                                                                                      |
| `messages`                                                                                                | object\[]          | Sí          | —                      | Turnos alternos de `user` y `assistant`; `content` es una cadena o un array de bloques de contenido. El último turno debe ser `user`. Excepción: para continuar una respuesta `pause_turn`, vuelve a enviar su contenido como último mensaje `assistant`. |
| `system`                                                                                                  | Cadena u object\[] | No          | —                      | Prompt del sistema.                                                                                                                                                                                                                                       |
| `thinking`                                                                                                | Objeto             | No          | `{"type": "adaptive"}` | El razonamiento es adaptativo y siempre está activo. `display`: `omitted` (predeterminado) o `summarized`.                                                                                                                                                |
| `output_config.effort`                                                                                    | Enum               | No          | `medium`               | `low`, `medium`, `high`, `xhigh`, `max`. Orienta cuánto razona el modelo.                                                                                                                                                                                 |
| `output_config.format`                                                                                    | Objeto             | No          | —                      | Un esquema JSON para la salida estructurada.                                                                                                                                                                                                              |
| `stop_sequences`                                                                                          | string\[]          | No          | —                      | Detiene la generación al producirse una de estas cadenas.                                                                                                                                                                                                 |
| `stream`                                                                                                  | Booleano           | No          | `false`                | Envía la respuesta como eventos del servidor.                                                                                                                                                                                                             |
| `temperature`                                                                                             | Número             | No          | —                      | Solo se acepta `1` (el valor predeterminado) por compatibilidad con versiones anteriores; cualquier otro valor devuelve un error 400. Omítelo.                                                                                                            |
| `top_p`                                                                                                   | Número             | No          | —                      | Solo se aceptan valores de `0.99` a `1` por compatibilidad con versiones anteriores; cualquier otro valor devuelve un error 400. Omítelo.                                                                                                                 |
| `top_k`                                                                                                   | Entero             | No          | —                      | No se acepta: cualquier valor devuelve un error 400. Omítelo.                                                                                                                                                                                             |
| `tools`                                                                                                   | object\[]          | No          | —                      | Definiciones de herramientas.                                                                                                                                                                                                                             |
| `tool_choice`                                                                                             | Objeto             | No          | —                      | `auto` o `none`; este modelo no permite forzar una herramienta (`any` o `tool`).                                                                                                                                                                          |
| `metadata.user_id`                                                                                        | Cadena             | No          | —                      | Un identificador opaco para el usuario final, de hasta 512 caracteres.                                                                                                                                                                                    |
| `cache_control`                                                                                           | Objeto             | No          | —                      | Punto de caché del prompt de nivel superior.                                                                                                                                                                                                              |
| `container`, `context_management`, `mcp_servers`, `diagnostics`, `service_tier`, `inference_geo`, `speed` | —                  | No          | —                      | Campos nativos opcionales; consulta la compatibilidad actual de la API para ver los campos filtrados por esta conexión.                                                                                                                                   |

## Razonamiento y herramientas [#razonamiento-y-herramientas]

Claude Opus 5.5 siempre usa razonamiento adaptativo: el modelo decide cuánto razonar y `output_config.effort` lo orienta. Un esfuerzo mayor suele implicar más tokens de salida, más tiempo de espera y un coste superior. Con `thinking.display` en `summarized`, la respuesta incluye bloques `thinking` que puedes mostrar; con `omitted`, se omiten. Los tokens de razonamiento se facturan como tokens de salida.

## 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 Opus 5.5

`claude-opus-5-5`

| Tokens facturables | claude · Predeterminado · Todas las longitudes de entrada |
| --- | ---: |
| Entrada (sin caché) | 2 US$ |
| Salida | 10 US$ |
| Lectura de caché | 0,1 US$ |
| Escritura en caché · 5 minutos | 2,5 US$ |
| Escritura en caché · 1 hora | 4 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-opus-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-opus-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-opus-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.
