Claude Fable 5.2 API key: cómo usarla con una clave normal

Claude Fable 5.2, que Anthropic publicó el 9 de noviembre de 2026, no tiene una API key propia ni exige rellenar una solicitud. Se llama con una clave normal de Claude Console, la que empieza por sk-ant- y sirve para cualquier otro modelo de Claude, escribiendo claude-fable-5-2 en el campo model de la petición. La clave, sin embargo, es solo una de las condiciones: el resto depende de la organización a la que pertenece, que necesita crédito, retención de datos de 30 días (la opción por defecto) y estar en una región admitida, y España y México lo están.

Así que el camino es corto: crea la clave en la página de API keys de Claude Console, carga crédito o vincula los créditos mensuales de API si tienes Max, Ultra o Team, y lanza la petición de ejemplo de más abajo. Una suscripción Pro o Max por sí sola no paga las llamadas a la API, aunque en la app de Claude ya puedas elegir Fable 5.2.

En una prueba del 12 de noviembre de 2026, una petición a api.anthropic.com con el modelo claude-fable-5-2 y sin clave válida devolvió un 401 en menos de un segundo, antes de mirar el nombre del modelo. Ese mismo día, la misma petición enviada a través de la pasarela laozhang.ai respondió con model: claude-fable-5-2 y la respuesta correcta.

Aviso: laozhang.ai es un servicio propio. Sus precios son nuestra tarifa, no una comparación independiente.

¿Dónde está mi API key de Claude? Se crea en Console y se ve una sola vez

La API key de Claude no aparece en claude.ai ni en la app: se crea en Claude Console, en platform.claude.com/settings/keys, y Console muestra la clave completa una única vez, en el momento de crearla. Si la perdiste, no hay forma de volver a verla; crea otra y borra la antigua. Los pasos, según la guía de Anthropic para obtener una API key, son estos:

1. Entra en platform.claude.com con tu cuenta o crea una.
2. Abre la página API keys (platform.claude.com/settings/keys).
3. Pulsa Create key, ponle un nombre, elige la caducidad y, en Linked account, selecciónate a ti o a una cuenta de servicio. Si quieres, asóciala a un workspace.
4. Copia la clave que empieza por sk-ant- y guárdala en un gestor de secretos o en una variable de entorno, porque Console no te la volverá a enseñar.

Elige el tipo de clave según quién la va a usar. Una clave personal actúa en tu nombre y deja de funcionar si sales de la organización, así que para un servidor, una CI o un agente conviene una clave de cuenta de servicio. Si el botón Create key aparece desactivado, tu rol en la organización no permite crear claves y tiene que hacerlo, o darte permiso, alguien con rol de administrador.

No existe una clave «para Fable 5.2». Una clave llama a todos los modelos que su organización puede usar y el modelo se elige en el cuerpo de cada petición, de modo que lo que decide si Fable 5.2 responde no es la clave, sino la organización.

Qué tiene que cumplir tu organización para que Fable 5.2 responda

Para que una llamada a claude-fable-5-2 salga bien, la organización necesita a la vez una clave activa, crédito, retención de datos de 30 días y estar en una región admitida; además cuentan los límites de su nivel de uso y, si la clave no está ligada a un workspace, una cabecera más. Cada condición se comprueba en un sitio distinto y falla de forma distinta, y a 12 de noviembre de 2026 queda así según la documentación de Anthropic:

La retención es la condición que más sorprende, porque no afecta a otros modelos. Fable 5.2 es uno de los «modelos cubiertos» junto con Mythos 5.2, Fable 5.1, Mythos 5.1, Fable 5 y Mythos 5: exige la retención estándar de 30 días y no está disponible con retención cero de datos salvo autorización expresa de Anthropic, según la página de Anthropic sobre la retención de datos de la API. Si tu empresa firmó ZDR, ese es el bloqueo, no la clave.

Los límites se fijan por organización y por nivel de uso, no por clave. Las organizaciones nuevas pueden empezar en el nivel Evaluation, con límites inferiores a los estándar que Anthropic no publica; los tuyos aparecen en la página Rate limits de Console. Los límites estándar de Fable 5.2, según la documentación de límites de la API de Claude, son de 4.000 peticiones, 500.000 tokens de entrada y 100.000 tokens de salida por minuto en el nivel Start; 10.000, 1.500.000 y 300.000 en Build; y 13.000, 4.000.000 y 800.000 en Scale. Fable 5.2 tiene su propio cupo, separado del que comparten Fable 5.1 y Fable 5. Cada nivel tiene además un tope de gasto mensual (500 $ en Start, 1.000 $ en Build y 200.000 $ en Scale) y, para subir, se usa el botón Request tier increase de la misma página. Cuánto crédito hace falta para pasar de un nivel al siguiente no está publicado.

Cómo usar la API key de Claude con Fable 5.2: la primera llamada

La primera llamada es una petición POST a https://api.anthropic.com/v1/messages con tu clave en la cabecera x-api-key, la versión de la API en anthropic-version y claude-fable-5-2 como modelo. Esta es la forma del ejemplo de cURL de la guía de inicio rápido de Claude, con el modelo cambiado:

export ANTHROPIC_API_KEY="sk-ant-..."

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -d '{
    "model": "claude-fable-5-2",
    "max_tokens": 1000,
    "messages": [
      {"role": "user", "content": "Reply with exactly: ready. Then on a new line give 17 * 23."}
    ]
  }'

Fable 5.2 piensa siempre de forma adaptativa, así que lo más seguro es no enviar thinking, o enviarlo como {"type": "adaptive"}: la API devuelve un 400 si llega {"type": "enabled"} con budget_tokens o {"type": "disabled"}. También devuelve un 400 con un tool_choice forzado (any o tool) y con temperature, top_p o top_k en valores distintos del predeterminado, como se detalla en la tabla de errores. Los SDK oficiales leen ANTHROPIC_API_KEY de la variable de entorno sin más configuración. La guía de la API key también acepta la clave como Authorization: Bearer <clave>, y para desarrollo en local Anthropic propone iniciar sesión con su CLI (ant auth login) en lugar de usar una clave.

Para saber si funcionó, mira tres campos de la respuesta. model dice qué modelo contestó, content trae un bloque thinking (puede llegar vacío) seguido del bloque text con la respuesta, y usage dice cuántos tokens te van a cobrar. Esta es la respuesta, recortada, que devolvió el formato Messages el 12 de noviembre de 2026 a través de la pasarela laozhang.ai con la misma petición y max_tokens: 2048:

Aviso: laozhang.ai es un servicio propio. Sus precios son nuestra tarifa, no una comparación independiente.

{
  "model": "claude-fable-5-2",
  "content": [
    { "type": "thinking", "thinking": "", "signature": "..." },
    { "type": "text", "text": "ready\n391" }
  ],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 33, "output_tokens": 16 }
}

Llegó en 5,53 segundos. A precio de lista, la llamada cuesta 33 × 8 $ / 1.000.000 + 16 × 40 $ / 1.000.000 = 0,000264 $ + 0,00064 $, es decir, unos 0,0009 $. Con "output_config": {"effort": "low"} la misma petición tardó 3,07 segundos, vino solo con el bloque de texto y gastó 6 tokens de salida; con effort en high, que es el valor por defecto en la API, volvió el bloque thinking y los 16 tokens. El formato compatible con OpenAI de esa pasarela (/v1/chat/completions) también devolvió model: claude-fable-5-2 con 33 y 16 tokens. Son una sola llamada por configuración, así que los tiempos son una muestra, no una medida de latencia.

Contra api.anthropic.com la prueba de ese día se hizo sin una clave válida. Sin cabecera de clave, la API respondió 401 authentication_error con el mensaje x-api-key header is required; con una clave inventada respondió invalid x-api-key, igual con anthropic-version: 2023-06-01 que con 2026-10-21, y GET /v1/models dio el mismo 401. La clave se comprueba antes que el modelo, la versión o el cuerpo, de modo que mientras veas un 401 no tiene sentido tocar nada más de la petición.

Errores de la API de Fable 5.2 y qué condición falta en cada uno

Cada error de la API de Claude apunta a una condición concreta: el 401 a la clave, el 400 a la retención de datos o a un parámetro, el 404 al nombre del modelo y el 429 a los límites o al tope de gasto. De la tabla, solo los dos 401 (sin clave y con una clave inventada) se reprodujeron el 12 de noviembre de 2026 en api.anthropic.com; el resto, incluidos los 400, es el comportamiento que documenta Anthropic en su lista de errores de la API de Claude y en las novedades de Fable 5.2.

Si llamas a través de una pasarela, los códigos son los suyos. En laozhang.ai, el 12 de noviembre de 2026, los ID claude-fable-5.2, fable-5-2, claude-fable-5-2-latest y el de Bedrock global.anthropic.claude-fable-5-2 devolvieron 503 api_error con el mensaje «Current group default has no available channels for model…», no un 404, y una clave inventada dio 401 con «Invalid token.». Esa misma pasarela aceptó con un 200 dos campos que Anthropic documenta como rechazados: thinking: {"type": "disabled"}, que además no quitó el bloque de razonamiento, y temperature: 0.2. Solo tool_choice: {"type": "any"} falló en las dos. La consecuencia práctica es que un código que funciona en una pasarela puede recibir un 400 cuando lo apuntas a api.anthropic.com.

Aviso: laozhang.ai es un servicio propio. Sus precios son nuestra tarifa, no una comparación independiente.

¿Es gratis la API de Claude Fable 5.2? Crédito prepago y créditos de Max

No: la API de Claude se paga con crédito prepago y Fable 5.2 cuesta 8 $ por millón de tokens de entrada y 40 $ por millón de salida, según la ficha de Fable 5.2 de Anthropic. El crédito se compra en Console > Billing > Buy credits con rol de administrador o de facturación, está disponible al momento y caduca un año después de la compra, sin reembolso. Antes de la primera compra Console pide datos de la organización y del uso previsto. Las peticiones fallidas no se cobran, pero una que iba a completarse y se corta porque tu cliente se desconecta o agota el tiempo de espera sí, según la ayuda de Anthropic sobre cómo pagar la API. Cómo comprar crédito paso a paso está en Claude API key gratis: crédito de prueba, Max y cómo comprar.

Hay dos formas de tener crédito sin comprarlo. Anthropic da a los usuarios nuevos un crédito gratuito para probar la API, pero no publica cuánto ni si alcanza para llamar a Fable 5.2 desde el nivel Evaluation. La otra son los créditos mensuales de API incluidos en Max (100 $), Ultra (200 $) y Team (20 $ por puesto Standard y 100 $ por puesto Premium, con un máximo de 500 $ al mes): se activan en claude.ai > Settings > Billing > API credits > Link organization tras siete días en el plan, solo se puede vincular una organización de Console, se gastan antes que el crédito comprado y lo que no uses caduca con cada ciclo. Sirven para cualquier modelo disponible en la API, también Fable 5.2, según la ayuda de Anthropic sobre los créditos mensuales de API. Free, Pro y Enterprise no los tienen.

Lo que ves en la app de Claude es otro contrato. Fable 5.2 está en todos los planes de pago para chatear, y en Pro va con créditos de uso de pago, salvo la oferta de lanzamiento que lo incluye hasta el 16 de noviembre de 2026 a las 23:59 (hora del Pacífico); nada de eso da una API key ni saldo de API. Las ofertas de Fable 5.2 «gratis» con una clave que circulan en vídeos se basan en el crédito de bienvenida de pasarelas de terceros, no en crédito de Anthropic. Qué incluye cada plan dentro de la app está en Límites de Claude Fable 5.1: qué incluye tu plan y cuándo pagas aparte.

Otras vías para llamar a Fable 5.2 y el ID de modelo de cada una

Si tu empresa ya paga AWS, Google Cloud o Microsoft, puedes usar Fable 5.2 allí con la cuenta de esa nube, sin clave de Anthropic, pero el ID y la credencial cambian según la vía. Cada nube factura y aplica límites en su propia cuenta. A 12 de noviembre de 2026, la sección de disponibilidad de las novedades de Fable 5.2 y la documentación de laozhang.ai dicen esto:

Aviso: laozhang.ai es un servicio propio. Sus precios son nuestra tarifa, no una comparación independiente.

Bedrock es la vía que más confunde: una clave sk-ant- no sirve ahí, y el ID lleva el prefijo de región del perfil de inferencia.

laozhang.ai tiene claude-fable-5-2 desde el 10 de noviembre de 2026 al mismo precio de lista que Anthropic, así que no es una vía más barata, sino otro contrato con su propia clave y su propio saldo. El formato Messages de Anthropic va a https://api.laozhang.ai/v1/messages con un token del grupo Claude Code, y el compatible con OpenAI a /v1/chat/completions con un token del grupo default, según su documentación del protocolo de Claude. No tiene las herramientas de servidor de Anthropic (web_search, web_fetch, code_execution devuelven 400), ni Message Batches, count_tokens o la API de archivos, y su documentación no incluye el modo rápido.

Hay más pasarelas de terceros que revenden Fable 5.2, cada una con su propia clave y sus propias condiciones. Con cualquiera de ellas, la prueba es la misma que arriba: comprueba que el campo model de la respuesta diga claude-fable-5-2 y que los tokens de usage, multiplicados por el precio de lista, cuadren con lo que te cobran.

Fable 5.2 en Claude Code con API key: hace falta la versión 2.1.321

Tu API key también vale en Claude Code, pero Fable 5.2 exige Claude Code 2.1.321 o posterior; se elige con /model fable o arrancando con claude --model claude-fable-5-2. Con ANTHROPIC_API_KEY definida, Claude Code cobra a la organización de Console a precio de API, y los créditos mensuales de Max, Ultra o Team no cubren el uso interactivo de Claude Code.

La versión importa más de lo que parece. En una prueba del 10 de noviembre de 2026 contra un servidor simulado local, Claude Code 2.1.321 envió tanto fable como claude-fable-5-2 como claude-fable-5-2, con effort medium y max_tokens de 128000. La versión 2.1.316, en cambio, convirtió fable en claude-fable-5-1, y con claude-fable-5-2 mostró «Claude Code doesn't recognize the model … assumes a context window of 200k tokens» y mandó la petición con max_tokens de 32000. El 12 de noviembre de 2026, claude --version en esa misma máquina seguía mostrando 2.1.316, así que ejecuta claude --version antes de dar por hecho que estás en Fable 5.2. La guía de configuración de modelos de Claude Code explica cómo fijar el modelo.

Para usar Claude Code a través de laozhang.ai se definen ANTHROPIC_BASE_URL=https://api.laozhang.ai (sin /v1) y ANTHROPIC_AUTH_TOKEN con un token del grupo Claude Code. Si dudas de a quién factura Claude Code cuando tienes clave y suscripción a la vez, lo resuelve Claude Code: API key o suscripción, cuál manda en la facturación.

Aviso: laozhang.ai es un servicio propio. Sus precios son nuestra tarifa, no una comparación independiente.

Más preguntas sobre la API key de Claude Fable 5.2

¿Hay que solicitar acceso a Fable 5.2 como a Claude Mythos 5.2?

No. A 12 de noviembre de 2026, Mythos 5.2 (claude-mythos-5-2) tiene las mismas especificaciones y el mismo precio que Fable 5.2, pero solo lo pueden llamar organizaciones verificadas a través de programas de Anthropic como el Cyber Verification Program, y una clave normal no llega a él. Fable 5.2 no tiene ese requisito, según la ficha de Fable 5.2 de Anthropic.

¿Me sirve la API key que usaba con Fable 5.1?

Sí, la misma clave llama a Fable 5.2 si la organización cumple las condiciones de retención y crédito; solo cambia el ID a claude-fable-5-2. Fable 5.2 tiene un cupo de límites por minuto separado del que comparten Fable 5.1 y Fable 5, así que no te resta del que ya usas. Eso sí, revisa que tu código no envíe thinking con budget_tokens, temperature ni un tool_choice forzado, porque Fable 5.2 los rechaza con un 400 en la API de Claude.

¿Qué sale más barato, Fable 5.2 u Opus 5.5?

Depende del effort y del tipo de tarea, más que del precio por token. La comparación por nivel de effort está en Claude Fable 5.2 vs Opus 5.5: cuál es mejor y con qué effort, y el cambio de coste frente a la versión anterior en Claude Fable 5.2 vs 5.1: más barata en medium, más cara en high.