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

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

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.

Configuración del modelo

AjusteClaude Haiku 5.5
ID del modeloclaude-haiku-5-5
Salida síncrona máxima128000 tokens, incluido el razonamiento
Modos de razonamientoAdaptativo o desactivado
Esfuerzo predeterminadomedium
Llamadas forzadas a herramientas (any / tool)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-haiku-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-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

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

CampoObligatorioContrato
modelSíclaude-haiku-5-5.
max_tokensSíEntero entre 0 y 128000, incluido el razonamiento. Sin valor predeterminado en la API.
messagesSí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.
systemNoCadena o array de bloques de texto. No admite null.
thinkingNoAdaptativo por defecto, o desactivado. Sin presupuesto manual ni modo entre herramientas.
output_configNoObjeto con effort, format y el campo beta opcional task_budget.
stop_sequencesNoArray de cadenas de parada.
streamNoBooleano; false por defecto.
temperatureNoOmítelo. Se descarta aquí; el valor oficial de compatibilidad es 1.
top_pNoOmítelo. Se descarta aquí; el valor oficial de compatibilidad es 0.99.
top_kNoNo admitido; se descarta.
toolsNoArray de herramientas del cliente o declaraciones oficiales de herramientas del servidor.
tool_choiceNoauto, none, any o tool con nombre. Se permiten llamadas forzadas a herramientas.
metadataNoObjeto; el campo opcional user_id es una cadena de hasta 512 caracteres o null.
cache_controlNoNull o {"type":"ephemeral","ttl":"5m"}; TTL también admite 1h. El TTL predeterminado es 5m.
containerNoNull, cadena con el ID del contenedor u objeto con ID opcional y hasta 20 skills.
context_managementNoNull u objeto con ediciones oficiales del contexto; se aplican las cabeceras beta.
mcp_serversNoArray de hasta 20 servidores URL; requiere la cabecera beta MCP correspondiente.
service_tierNoauto o standard_only. Haiku no tiene capacidad Priority Tier.
inference_geoNoglobal, 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.
diagnosticsNoNull u objeto; previous_message_id es null o una cadena de hasta 256 caracteres.
compactionNoNull o {"type":"summarize","instructions":"..."}. Las instrucciones son opcionales, admiten null y tienen un máximo de 16384 caracteres.
fallbacksNoNull o default con la beta correspondiente. Haiku no tiene modelos alternativos automáticos; las listas explícitas no son válidas.
fallback_credit_tokenNoNull, 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.
speedNostandard o null. El modo rápido no está admitido.

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.

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

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.

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

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

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

claude-haiku-5-5

Claude Haiku 5.5 — USD por 1 millón de tokens
Tokens facturablesclaude · Predeterminado
≤ 100.000 tokens de entrada> 100.000 tokens de entrada
Entrada (sin caché)0,05 US$0,25 US$
Salida0,25 US$1,25 US$
Lectura de caché0,005 US$0,025 US$
Escritura en caché · 5 minutos0,0625 US$0,3125 US$
Escritura en caché · 1 hora0,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

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

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-haiku-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-haiku-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 general de Haiku 5.5
  • Guía de migración a Haiku 5.5
  • Referencia de Messages
  • Referencia de Messages beta
  • Razonamiento, esfuerzo, presupuestos de tareas
  • Compactación bajo demanda, Edición del contexto
  • Caché de prompts, Visión, Compatibilidad con PDF

API de Claude

Usa Claude con Anthropic Messages u OpenAI Chat Completions. IDs, ejemplos de streaming y precios de entrada, salida y caché por grupo.

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.

Índice

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