# API de Claude Fable 5.2 (https://wanapi.app/es/docs/claude-fable-5-2)





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](/es/docs/claude-api).

## Configuración del modelo [#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 [#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-fable-5-2",
    "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-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 [#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]

| 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 [#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 [#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 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 [#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-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 [#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-fable-5-2","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-fable-5-2`. 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.

## Referencias del modelo [#referencias-del-modelo]

* [Descripción general del modelo](https://platform.claude.com/docs/en/models/fable-5-2/overview)
* [Referencia de Messages](https://platform.claude.com/docs/en/api/beta/messages/create)
* [Razonamiento](https://platform.claude.com/docs/en/build-with-claude/thinking)
