LogoDocumentación de Wan API
Página de inicio
X (Twitter)
Página de inicio

Primeros pasos

Descripción generalGuía de integraciónConsultar saldoEliminar una tarea

Modelos Wan

Wan 3.0Wan 3.0 PrimeWan 3.0 ProWan 3.0 Prime Pro

Modelos Seedance

Seedance 2.5Seedance 2.5 FlashSeedance 2.0Seedance 2.0 FastSeedance 2.0 Mini

Modelos de imagen

Seedream 5.0 ProAPI de Seedream 5.5

Modelos de lenguaje

API de ClaudeClaude Haiku 5.5Claude Sonnet 5.5Claude Opus 5.5Claude Fable 5.2API de GPTGPT Luna 6GPT Terra 6.1GPT Sol 6.1GPT Astra 6
X (Twitter)

API de 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.

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.

Configuración del modelo

AjusteClaude Sonnet 5.5
ID del modeloclaude-sonnet-5-5
Ventana de contexto1M tokens
Salida síncrona máxima128000 tokens, incluido el razonamiento
Modos de razonamientoAdaptativo o between_tools
Esfuerzo predeterminadohigh
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-sonnet-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-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

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

ParámetroTipo / obligatoriedadRestricciones y valores predeterminados oficiales
modelCadena, obligatorioclaude-sonnet-5-5.
max_tokensEntero, obligatorio0–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.
messagesArray de objetos, obligatorioAl 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.
systemCadena o array de bloques de textoInstrucciones de nivel superior. Los bloques de texto pueden incluir puntos de caché.
thinkingObjetoPredeterminado: {"type":"adaptive"}. El otro modo admitido es {"type":"between_tools"}. Se rechazan los presupuestos manuales y disabled.
thinking.displayEnumSolo en modo adaptativo: omitted (predeterminado) o summarized. Omitir el resumen no significa desactivar el razonamiento.
thinking.block_bindingObjeto, betaSolo en modo adaptativo. Requiere thinking-binding-controls-2026-08-01; sigue el contrato oficial de conservación del razonamiento.
output_config.effortEnum o nulllow, medium, high, xhigh, max; predeterminado: high. Null mantiene el valor predeterminado.
output_config.formatObjeto o nullSalida JSON estructurada: {"type":"json_schema","schema":{...}}. Usa el subconjunto admitido de JSON Schema.
streamBooleanoPredeterminado: false; true devuelve eventos SSE.
stop_sequencesArray de cadenasOficialmente, detiene la generación al encontrar una cadena coincidente. La comprobación de compatibilidad del proveedor no hizo efectivo este comportamiento.
temperatureNúmero o nullSolo se acepta 1 por compatibilidad; omítelo. Se rechazan los demás valores no nulos.
top_pNúmero o nullSolo se acepta 0.99–1 por compatibilidad; omítelo.
top_kNingún valor no nuloEl muestreo no está admitido; omite esta propiedad.
toolsArray de objetosLas 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_choiceObjetoauto (predeterminado) o none. Se rechazan any y tool forzado con nombre. auto puede incluir disable_parallel_tool_use.
metadata.user_idCadena o nullHasta 512 caracteres; usa un identificador opaco.
cache_controlObjeto o nulltype: "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.
diagnosticsObjeto o nullprevious_message_id: cadena de hasta 256 caracteres o null. Solicita diagnósticos de divergencia de caché.
service_tierEnumauto (predeterminado) o standard_only.
speedEnum o nullOmítelo o usa standard / null. Sonnet 5.5 no admite fast.
inference_geoCadena o nullEl valor predeterminado oficial procede de la configuración de la cuenta. Que se acepte una solicitud no confirma dónde se procesa.
fallbacksCadena, 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_tokenCadena, objeto o nullUn 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.
containerCadena, objeto o nullID 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_managementObjeto o nullConfiguració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_serversArray de objetosDefiniciones 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.
compactionObjeto 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.effortEnum, betaEsfuerzo 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

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:

{
  "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

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 Sonnet 5.5

claude-sonnet-5-5

Claude Sonnet 5.5 — USD por 1 millón de tokens
Tokens facturablesclaude · Predeterminado
Todas las longitudes de entrada
Entrada (sin caché)1 US$
Salida5 US$
Lectura de caché0,05 US$
Escritura en caché · 5 minutos1,25 US$
Escritura en caché · 1 hora2 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-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

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-sonnet-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-sonnet-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

  • Descripción oficial de Sonnet 5.5
  • Cambios y restricciones de Sonnet 5.5
  • Referencia de parámetros de Messages
  • Esfuerzo por mensaje
  • Compactación bajo demanda
  • Rechazos y modelos alternativos
  • Crédito para modelos alternativos

Claude Haiku 5.5

API de Claude Haiku 5.5: razonamiento adaptativo o desactivado, herramientas forzadas, parámetros, streaming y precios por grupo.

Claude Opus 5.5

API de Claude Opus 5.5: razonamiento adaptativo, esfuerzo medio por defecto, parámetros, streaming y precios por grupo.

Índice

Configuración del modeloConexión y primera solicitudCompatibilidad actual de la APIParámetrosRazonamiento y herramientasEntrada multimediaPreciosRespuesta y streamingFormatos compatibles con OpenAIRegistros de uso y erroresReferencias del modelo