API de Claude Opus 5.5
API de Claude Opus 5.5: razonamiento adaptativo, esfuerzo medio por defecto, parámetros, streaming y precios por grupo.
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.
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
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-opus-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-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
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
| 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
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
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 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
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-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
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-opus-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-opus-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.