API de Claude Fable 5.2
API de Claude Fable 5.2: razonamiento adaptativo, esfuerzo alto por defecto, parámetros, requisitos beta y precios por grupo.
Esta referencia presenta Claude Fable 5.2 y sus parámetros específicos de Messages. Usa claude-fable-5-2 con POST https://api.wanapi.app/v1/messages. Compara los modelos Claude.
Configuración del modelo
| Ajuste | Claude Fable 5.2 |
|---|---|
| ID del modelo | claude-fable-5-2 |
| Ventana de contexto | 1M tokens |
| Salida síncrona máxima | 128000 tokens, incluido el razonamiento |
| Modos de razonamiento | Adaptativo, siempre activo |
| Esfuerzo predeterminado | high |
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-fable-5-2",
"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-fable-5-2",
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
| Campo | Tipo / valor predeterminado | Restricción |
|---|---|---|
model | Cadena obligatoria | claude-fable-5-2. Usa el ID exacto; el grupo se selecciona automáticamente. |
max_tokens | Entero obligatorio | 0–128000, incluido el razonamiento. Cero no puede combinarse con stream true, salida estructurada o herramientas forzadas. |
messages | Array obligatorio | 1–100000 turnos oficiales; solo puede estar vacío al continuar un hilo después de pause_turn. |
system | Cadena o array de bloques de texto | Omítelo por completo al continuar un hilo. |
thinking | Objeto, adaptativo por defecto | Solo adaptive. display: omitted (predeterminado), summarized, updates o null. |
output_config | Objeto | effort: low, medium, high (predeterminado), xhigh, max o null. format y task_budget opcionales. |
output_format | Objeto o null | Alias obsoleto de salida estructurada; se recomienda output_config.format. |
stop_sequences | Array de cadenas | No admite null; incompatible con la compactación bajo demanda. |
stream | Booleano, false | SSE si es true; no admite null. |
tools | Array | Herramientas oficiales del cliente y herramientas o conjuntos de herramientas del servidor. Tu aplicación ejecuta las herramientas del cliente. |
tool_choice | Objeto | auto o none; se rechazan las llamadas forzadas a herramientas. |
metadata | Objeto | user_id es una cadena de hasta 512 caracteres o null. |
cache_control | Objeto o null | type ephemeral, ttl 5m o 1h. |
container | Cadena, objeto o null | id opcional y hasta 20 skills. |
context_management | Objeto o null | Ediciones oficiales del contexto; requiere la beta correspondiente. |
mcp_servers | Array | Hasta 20 servidores HTTPS; requiere la beta MCP correspondiente. |
diagnostics | Objeto o null | previous_message_id es una cadena de hasta 256 caracteres o null. |
service_tier | auto o standard_only | Opcional; no admite null. |
inference_geo | Cadena o null | global o us, según la disponibilidad de la cuenta. |
speed | Cadena o null | standard, fast o null; fast no necesita beta. |
compaction | Objeto o null | type summarize, instructions opcionales de hasta 16384 caracteres Unicode. |
fallbacks | default, array o null | Hasta tres destinos distintos; requiere la beta oficial de modelos alternativos en el servidor. |
fallback_credit_token | Cadena, objeto o null | Token de hasta 2048 caracteres; requiere la beta oficial de crédito; no puede combinarse con fallbacks. |
thread | Objeto o null | create, o continue con previous_message_id; requiere message-threads-2026-08-12. |
Razonamiento y herramientas
Claude Fable 5.2 usa por defecto razonamiento adaptativo con esfuerzo high. No admite los modos de razonamiento enabled, disabled o between_tools, ni budget_tokens. thinking.display: updates necesita thinking-display-updates-2026-08-18. thinking.block_binding admite prefix_mismatch_behavior con error, drop_block o null mediante thinking-binding-controls-2026-08-01.
output_config.task_budget requiere task-budgets-2026-03-13, type tokens, un total entero de al menos 20000 y un remaining opcional de tipo entero no negativo. Omite remaining al usar compaction o volver a enviar un bloque de compactación firmado. La compactación bajo demanda requiere compact-2026-09-04 y no puede combinarse con context_management, stop_sequences, salida estructurada o herramientas forzadas. La compactación por umbral usa compact-2026-01-12, con un disparador input_tokens de al menos 50000.
El esfuerzo por mensaje en los mensajes del sistema requiere mid-conversation-output-config-2026-07-01. Se rechaza el prellenado del mensaje final del asistente; las continuaciones oficiales de pause_turn y compaction siguen siendo válidas.
Usa computer_toolset_20260801 para el uso del ordenador. Las herramientas de asesor requieren advisor-tool-2026-03-01 y un destino admitido. Tu aplicación controla la ejecución de herramientas y sus permisos.
La continuación de un hilo solo envía mensajes nuevos y debe omitir system y tools. No puede combinarse con compaction ni con ediciones del contexto, salvo conservar todo el razonamiento. El estado caduca tras cinco minutos sin solicitudes; guarda la conversación localmente. Las restricciones que dependen del estado se comprueban al continuar.
Los modelos alternativos de Fable 5.2 son Claude Opus 4.8 y Claude Opus 5. La ejecución de funciones beta avanzadas y la facturación del modo rápido requieren una verificación en vivo; el esquema de solicitud no garantiza una capacidad comprobada.
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 Fable 5.2
claude-fable-5-2
| Tokens facturables | claude · Predeterminado |
|---|---|
| Todas las longitudes de entrada | |
| Entrada (sin caché) | 4 US$ |
| Salida | 20 US$ |
| Lectura de caché | 0,1 US$ |
| Escritura en caché · 5 minutos | 5 US$ |
| Escritura en caché · 1 hora | 8 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-fable-5-2",
"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-fable-5-2","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-fable-5-2. 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.