guides

Claude Fable 5.2 API: precios, configuración y código

Poyo.ai Team
19 min read
Share:

Puntos clave

  • ID del modelo: claude-fable-5-2. Lanzado el 9 de noviembre de 2026, con una ventana de contexto de 1M tokens y hasta 128K tokens de salida por solicitud.
  • Precio: $8 / $40 por millón de tokens de entrada/salida en la API de Anthropic, un 20% menos que Fable 5.1. En PoYo cuesta $6.40 / $32.
  • Dos formas de llamarlo en PoYo: el formato Messages de Anthropic en POST https://api.poyo.ai/v1/messages, o el endpoint compatible con OpenAI POST https://api.poyo.ai/v1/chat/completions. Los SDK oficiales de Anthropic funcionan configurando la URL base como https://api.poyo.ai.
  • El razonamiento está siempre activado. La profundidad y el coste se controlan con output_config.effort. El valor predeterminado es high; usa medium o low para el trabajo rutinario.
  • El razonamiento se factura como salida. Una respuesta corta puede consumir miles de tokens de salida con el esfuerzo high, así que fija effort de forma explícita y dimensiona max_tokens para el razonamiento más la respuesta.
  • Lee primero stop_reason. Te indica si el modelo terminó, llamó a una herramienta, alcanzó max_tokens o devolvió un refusal de seguridad, así que compruébalo antes de leer el contenido.

Claude Fable 5.2 API de un vistazo

Claude Fable 5.2
ID del modelo en la APIclaude-fable-5-2
Lanzamiento9 de noviembre de 2026
Ventana de contexto1M tokens
Salida máxima128K tokens por solicitud
Entrada → salidaTexto e imágenes → texto
RazonamientoAdaptativo, siempre activado
Niveles de esfuerzolow, medium, high (predeterminado), xhigh, max
Fecha de corte de conocimientosJunio de 2026
Retención de datosRetención de 30 días
Precio oficial (por 1M de tokens)$8 de entrada / $40 de salida / $0.20 de lectura de caché
Precio en PoYo (por 1M de tokens)$6.40 de entrada / $32 de salida / $0.16 de lectura de caché
Endpoints en PoYo/v1/messages, /v1/chat/completions

Anthropic presenta Fable 5.2 como el modelo para el razonamiento exigente y el trabajo agéntico de largo recorrido, y recomienda Claude Opus 5.5 como punto de partida para la mayoría de las cargas de trabajo. Si todavía estás decidiendo entre los dos, lee primero Claude Fable 5.2 vs. Opus 5.5. Esta guía se centra en la integración.

Un prototipo de sistema operativo creado por agentes de Claude Fable 5.2, funcionando en un portátil. Vídeo de los materiales de lanzamiento de Claude Fable 5.2 de Anthropic.

Fable 5, 5.1 o 5.2: ¿qué precio estás consultando?

Quien busca «precios de Claude Fable 5» puede referirse a cualquiera de los tres modelos Fable lanzados en 2026. Comparten la ventana de contexto de 1M y el límite de salida de 128K, y cada uno tiene su propio precio:

ModeloLanzamientoEntradaSalidaLectura de cachéID del modelo en la API
Claude Fable 59 de junio de 2026$10$50$1.00claude-fable-5
Claude Fable 5.11 de septiembre de 2026$10$50$0.25claude-fable-5-1
Claude Fable 5.29 de noviembre de 2026$8$40$0.20claude-fable-5-2

Precios oficiales en USD por millón de tokens. Fable 5.2 es la primera bajada de precio de la gama Fable y el modelo actual, así que los proyectos nuevos deberían empezar por él. El resto de esta guía trata sobre Fable 5.2.

Precios en resumen

Cargo (por 1M de tokens)Oficial de AnthropicPoYoCréditos de PoYo
Entrada$8.00$6.401.280
Salida (incluye el razonamiento)$40.00$32.006.400
Lectura de caché$0.20$0.1632
Escritura en caché (5 minutos)$10.00$8.001.600
Escritura en caché (1 hora)$16.00$12.802.560

PoYo factura por uso en créditos, a razón de $1 = 200 créditos, sin suscripción. Toda la ventana de contexto de 1M se factura a las tarifas estándar, así que un prompt de 900K tokens cuesta lo mismo por token que uno de 9K. Para el resto de modelos Claude, consulta nuestra guía de precios de Claude API.

Inicio rápido

  1. Crea una clave de API en el panel de PoYo.
  2. Envía las solicitudes a https://api.poyo.ai con el modelo configurado como claude-fable-5-2.
  3. Autentícate con x-api-key: YOUR_KEY en /v1/messages (también vale Authorization: Bearer YOUR_KEY), o con Authorization: Bearer YOUR_KEY en /v1/chat/completions.

curl (formato Messages de Anthropic)

curl https://api.poyo.ai/v1/messages \
  -H "x-api-key: $POYO_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-fable-5-2",
    "max_tokens": 16000,
    "output_config": {"effort": "medium"},
    "messages": [
      {"role": "user", "content": "Encuentra la condición de carrera en este pool de workers de Go y propón una solución: ..."}
    ]
  }'

La respuesta es un objeto Message estándar de Anthropic. La respuesta está en el bloque text de content; puede ir precedida de un bloque thinking.

Python (SDK de Anthropic)

import os
import anthropic

client = anthropic.Anthropic(
    base_url="https://api.poyo.ai",
    api_key=os.environ["POYO_API_KEY"],
)

with client.messages.stream(
    model="claude-fable-5-2",
    max_tokens=32000,
    output_config={"effort": "medium"},
    thinking={"type": "adaptive", "display": "summarized"},
    messages=[{"role": "user", "content": "Escribe un plan de migración de REST a gRPC para este servicio: ..."}],
) as stream:
    message = stream.get_final_message()

if message.stop_reason == "refusal":
    print("Request declined:", message.stop_details)
else:
    for block in message.content:
        if block.type == "thinking":
            print("Thinking summary:", block.thinking)
        elif block.type == "text":
            print(block.text)

print(message.usage)

El streaming mantiene las solicitudes largas a salvo de los tiempos de espera HTTP. Con el esfuerzo high o superior, una sola solicitud difícil puede durar varios minutos.

TypeScript (SDK de Anthropic)

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://api.poyo.ai",
  apiKey: process.env.POYO_API_KEY,
});

const message = await client.messages
  .stream({
    model: "claude-fable-5-2",
    max_tokens: 32000,
    output_config: { effort: "medium" },
    messages: [{ role: "user", content: "Revisa este pull request en busca de problemas de seguridad: ..." }],
  })
  .finalMessage();

if (message.stop_reason === "refusal") {
  console.log("Request declined:", message.stop_details);
} else {
  for (const block of message.content) {
    if (block.type === "text") console.log(block.text);
  }
}

Chat Completions compatible con OpenAI

Si tu stack ya usa el formato de solicitud de OpenAI, envía el mismo ID de modelo a /v1/chat/completions:

curl https://api.poyo.ai/v1/chat/completions \
  -H "Authorization: Bearer $POYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5-2",
    "messages": [
      {"role": "system", "content": "You are a senior data engineer."},
      {"role": "user", "content": "Diseña un esquema para la deduplicación de eventos en ClickHouse."}
    ],
    "stream": true
  }'

Con el SDK oficial de OpenAI, configura base_url como https://api.poyo.ai/v1. Usa /v1/messages cuando necesites controles propios de Claude, como output_config.effort, la visualización del razonamiento, cache_control y las definiciones de herramientas al estilo de Anthropic.

Esfuerzo: la principal palanca de calidad y coste

Fable 5.2 razona de forma adaptativa en cada solicitud. El ajuste effort dentro de output_config decide cuánto:

EsfuerzoÚsalo paraNotas
lowIntercambios rápidos, tareas bien especificadas, subagentes de gran volumenEl más rápido y económico. En tareas largas, añade una instrucción de «termina la tarea completa»
mediumProgramación interactiva, chat, trabajo de conocimiento cotidianoUna buena opción predeterminada para la mayor parte del tráfico de producto
high (predeterminado)Programación difícil, investigación, trabajo agéntico, ejecuciones largas sin supervisiónSegún Anthropic, la mayor parte de la mejora de capacidad ya está presente en high
xhighEl trabajo de programación y de agentes más difícil y de mayor duraciónÚsalo donde tus evaluaciones muestren una mejora medida; consume más tokens
maxMedir el techo, o tareas puntuales en las que la profundidad importa más que el tiempo y los tokensEl razonamiento más profundo y los turnos más largos

Gráfico de Anthropic de FrontierCode 2.0 que representa la puntuación frente al coste por tarea, con Claude Fable 5.2 en los esfuerzos low, medium, high, xhigh y max junto a otros modelos

Cómo el esfuerzo equilibra puntuación y coste por tarea en FrontierCode 2.0. Gráfico de los materiales de lanzamiento de Claude Fable 5.2 de Anthropic.

Tres reglas prácticas:

  • Fija el esfuerzo en cada solicitud. El código copiado de Opus 5.5 se ejecutaba con medium por defecto. En Fable 5.2, la misma solicitud se ejecuta con high y consume más tokens de salida.
  • Usa el esfuerzo para decidir cuánto razona. Para turnos más rápidos y económicos, Anthropic recomienda un nivel de esfuerzo menor en lugar de líneas en el prompt como «responde directamente sin deliberar». Con high o superior, Fable 5.2 razona antes de casi cada respuesta, incluso ante un saludo.
  • Usa el prompt para la longitud de la respuesta. El esfuerzo fija la profundidad del razonamiento; tu prompt fija la extensión de la respuesta final.

Para ver con un ejemplo medido lo que el esfuerzo hace con la factura, consulta los resultados prácticos de Claude Fable 5.2 vs. Opus 5.5: en una tarea de programación, Fable 5.2 obtuvo la misma puntuación con medium y con high, y con medium costó aproximadamente una cuarta parte.

Razonamiento adaptativo: qué significa «siempre activado» para tu código

  • Omite thinking o envía {"type": "adaptive"}. Esa es toda la configuración del razonamiento. La profundidad la marca effort, que sustituye a los antiguos ajustes budget_tokens y disabled.
  • Los tokens de razonamiento se facturan como salida y cuentan para max_tokens. Dimensiona max_tokens para el razonamiento más la respuesta: 16K es un buen mínimo, y 32K o más con streaming encaja con las tareas difíciles.
  • Los resúmenes del razonamiento se activan a petición. Por defecto, los bloques de razonamiento llegan con el campo thinking vacío, lo que mantiene el streaming rápido. Añade "display": "summarized" para recibir un resumen legible. En ambos modos se factura el razonamiento completo.
  • Deja el muestreo en manos del modelo. Envía las solicitudes sin temperature, top_p ni top_k; Fable 5.2 gestiona el muestreo por sí mismo.
  • Consulta usage. output_tokens ya incluye el razonamiento, y output_tokens_details.thinking_tokens indica la parte que corresponde al razonamiento.

Uso de herramientas

Fable 5.2 acepta auto (el valor predeterminado) o none en tool_choice. Nombra la herramienta en tu prompt cuando quieras que se llame:

{
  "model": "claude-fable-5-2",
  "max_tokens": 16000,
  "output_config": {"effort": "medium"},
  "tools": [
    {
      "name": "get_order_status",
      "description": "Look up an order by its ID and return the shipping status and carrier.",
      "input_schema": {
        "type": "object",
        "properties": {"order_id": {"type": "string"}},
        "required": ["order_id"]
      }
    }
  ],
  "tool_choice": {"type": "auto"},
  "messages": [
    {"role": "user", "content": "¿Dónde está el pedido A-1042? Compruébalo con get_order_status."}
  ]
}

Cuando el modelo llama a una herramienta, la respuesta termina con stop_reason: "tool_use". Ejecuta la herramienta y devuelve un bloque tool_result en el siguiente mensaje del usuario. Reenvía el turno completo del asistente sin cambios, incluidos los bloques de razonamiento.

Otras reglas que conviene conocer:

  • Usa auto o none en tool_choice. Para asegurarte de que se ejecuta una herramienta, nómbrala en el prompt. Cuando necesites JSON garantizado, usa la salida estructurada: output_config.format con un esquema JSON.
  • El uso del ordenador funciona mediante el conjunto de herramientas computer_toolset_20260801.
  • Analiza las entradas de las herramientas con un parser de JSON. Así se gestiona cualquier estilo de escape que el modelo use dentro de los argumentos.

Brazos robóticos controlados por Claude Fable 5.2 a partir de imágenes de cámara, resolviendo un cubo de rompecabezas. Vídeo de los materiales de lanzamiento de Claude Fable 5.2 de Anthropic.

1M de contexto y almacenamiento en caché de prompts

La ventana de 1M tokens admite unas 555.000 palabras en inglés, suficiente para una base de código grande o un montón de contratos en una sola solicitud. Fable 5.2 usa el tokenizador que se introdujo con Claude Opus 4.7, que genera más tokens para el mismo texto que los modelos anteriores a 4.7, así que cuenta los tokens de tus propios archivos antes de planificar en torno al límite.

Los prompts largos son donde la caché sale rentable. Una lectura de caché en Fable 5.2 cuesta el 2.5% del precio de entrada ($0.20 frente a $8 por millón de tokens). En PoYo, añade un cache_control de nivel superior y el último bloque que admite caché se guarda automáticamente:

{
  "model": "claude-fable-5-2",
  "max_tokens": 16000,
  "cache_control": {"type": "ephemeral", "ttl": "1h"},
  "output_config": {"effort": "medium"},
  "system": "You answer questions about the contract below. Quote clause numbers.\n\n<contract>...</contract>",
  "messages": [
    {"role": "user", "content": "Enumera cada derecho de rescisión y su plazo de preaviso."}
  ]
}

Coloca primero el contenido estable (prompt de sistema, definiciones de herramientas, el documento) y al final la pregunta que cambia. En una conversación de varios turnos o en un ciclo de agente, cada turno nuevo vuelve a leer el prefijo anterior desde la caché. La caché de 5 minutos cuesta 1.25× el precio de entrada al escribirla y se amortiza con una lectura; la de 1 hora cuesta 2× y se amortiza con dos.

Dos hábitos mantienen funcionando tanto la caché como el razonamiento del modelo a lo largo de los turnos:

  • Mantén el historial solo de adición. Cada bloque de razonamiento está ligado al prompt de sistema, las herramientas y los mensajes que lo precedieron. Mantén system y tools fijos durante una conversación y añade los turnos nuevos al final de messages. Si se editan turnos anteriores y se reenvían los bloques de razonamiento antiguos, la comprobación de prefijo de la API marca la solicitud con el mensaje The block is bound to a different conversation. Para cambiar las instrucciones, inicia una conversación nueva.
  • Cambia de modelo cuando quieras. Puedes cambiar model entre solicitudes de la misma conversación. Los bloques de razonamiento de Fable 5.2 los leen Fable 5.2 y Mythos 5.2; cuando la conversación pasa a otro modelo, como Opus 5.5, la API descarta esos bloques automáticamente, la solicitud se completa y el nuevo modelo continúa con su propio razonamiento. Cada modelo mantiene su propia caché.

Gestión de rechazos

Fable 5.2 ejecuta clasificadores de seguridad. Cuando uno de ellos detiene una solicitud, la respuesta llega como HTTP 200 con stop_reason: "refusal" y un objeto stop_details que indica el área de la política, por ejemplo cyber, bio o reasoning_extraction. Tu código debería:

  1. Comprobar stop_reason antes de leer content, como hacen los ejemplos de Python y TypeScript anteriores.
  2. Registrar stop_details.category para saber qué prompts lo activan.
  3. Enviar la solicitud a otro modelo, como Opus 5.5, o mostrar al usuario un mensaje claro.

Para ver cómo ha razonado el modelo, solicita el razonamiento con "display": "summarized". Así el razonamiento queda fuera del texto de la respuesta, que es el área que cubre la categoría reasoning_extraction.

Migración desde Fable 5.1 u Opus 5.5

Si vienes deQué cambia
Claude Fable 5.1Cambia el ID del modelo. Los precios bajan de $10 / $50 a $8 / $40. La comprobación de prefijo se aplica ahora a todas las cuentas, así que mantén los historiales solo de adición. Usa computer_toolset_20260801 para el uso del ordenador. Con la herramienta de asesor, configura el asesor como claude-fable-5-2. Repite tu barrido de esfuerzo empezando por high
Claude Opus 5.5El precio por token pasa de $4 / $20 a $8 / $40; las lecturas de caché se mantienen en $0.20. El esfuerzo predeterminado pasa de medium a high, así que fíjalo de forma explícita. Fable 5.2 funciona con retención de datos de 30 días. Las reglas de razonamiento y de tool_choice son las mismas
Claude Opus 5 o anterioresDeja que el razonamiento funcione de forma adaptativa y dirígelo con effort en lugar de disabled y budget_tokens. Usa tool_choice auto con una instrucción, o la salida estructurada para JSON. Deja que el modelo gestione el muestreo en lugar de temperature, top_p y top_k. Dimensiona max_tokens para el razonamiento más la respuesta

Merece la pena revisar los prompts heredados de modelos anteriores. Para tareas largas de varios pasos, Anthropic recomienda añadir al prompt de sistema una instrucción de «termina la tarea completa», sobre todo con los esfuerzos low y medium. Fable 5.2 sigue muy de cerca las reglas de estilo, así que relaja los límites estrictos de longitud de frase escritos para modelos anteriores para que su prosa suene natural. Inicia una conversación nueva cuando cambies el prompt.

Cuánto cuesta una solicitud

Los tokens de salida de la tabla incluyen el razonamiento. Todos los precios son por millón de tokens.

EscenarioTokensOficial ($8 / $40)PoYo ($6.40 / $32)
Respuesta de chat5K de entrada + 1K de salida0.005×8 + 0.001×40 = $0.0800.005×6.4 + 0.001×32 = $0.064 (12.8 créditos)
Revisión de código50K de entrada + 8K de salida0.05×8 + 0.008×40 = $0.720.05×6.4 + 0.008×32 = $0.576 (115.2 créditos)
Sesión de agente2M de lecturas en caché + 300K de entrada nueva + 150K de salida2×0.2 + 0.3×8 + 0.15×40 = $8.802×0.16 + 0.3×6.4 + 0.15×32 = $7.04
Documento de 800K tokens, primera pregunta800K escritos en la caché de 5 minutos + 10K de salida0.8×10 + 0.01×40 = $8.400.8×8 + 0.01×32 = $6.72
Mismo documento, pregunta de seguimiento800K de lectura de caché + 10K de salida0.8×0.2 + 0.01×40 = $0.560.8×0.16 + 0.01×32 = $0.45

Las filas del documento muestran por qué importa la caché: después de la primera pregunta, cada pregunta de seguimiento cuesta aproximadamente una quinceava parte. En la sesión de agente, la salida supone unos dos tercios de la factura, y por eso el esfuerzo es el primer ajuste que conviene afinar.

Usa Claude Fable 5.2 en PoYo

PoYo te ofrece Fable 5.2 un 20% por debajo de las tarifas oficiales por token de Anthropic, con algunas ventajas prácticas:

  • Una sola clave de API para todos los modelos. Fable 5.2, Opus 5.5, Sonnet 5.5, los modelos GPT y los modelos de imagen, vídeo y audio comparten la misma clave y el mismo panel.
  • Pago por uso. Los créditos se facturan por token, sin suscripción.
  • Los dos formatos de solicitud. Llama a Fable 5.2 con el formato Messages de Anthropic o con el formato Chat Completions de OpenAI usando el mismo ID de modelo.

Prueba tus prompts en el Playground de la página del modelo Claude Fable 5.2 y después lleva el mismo ID de modelo a producción. Para compararlo con la opción predeterminada del día a día, cambia "model" a claude-opus-5-5 en la página de Claude Opus 5.5 con la misma clave.

Preguntas frecuentes

¿Cuánto cuesta la API de Claude Fable 5.2?

$8 por millón de tokens de entrada y $40 por millón de tokens de salida en la API de Anthropic, con las lecturas de caché a $0.20. En PoYo, el mismo modelo cuesta $6.40 de entrada, $32 de salida y $0.16 por las lecturas de caché, por millón de tokens. Los tokens de razonamiento se facturan a la tarifa de salida.

¿Cuál es el precio de Claude Fable 5?

Claude Fable 5 (junio de 2026) cuesta $10 / $50 por millón de tokens de entrada/salida, con las lecturas de caché a $1. Fable 5.1 mantuvo el precio de $10 / $50 y rebajó las lecturas de caché a $0.25. Fable 5.2 lo baja a $8 / $40, con lecturas de caché a $0.20.

¿Cuál es el ID del modelo Claude Fable 5.2?

claude-fable-5-2, exactamente así. Úsalo en /v1/messages o en /v1/chat/completions.

¿Puedo usar el SDK de Anthropic con PoYo?

Sí. Configura la URL base como https://api.poyo.ai y pasa tu clave de PoYo como clave de API. El SDK envía x-api-key y anthropic-version por ti, y el streaming funciona con las utilidades de stream del SDK.

¿Cómo hago que Fable 5.2 razone menos?

Configura output_config.effort como low o medium. El razonamiento adaptativo se ejecuta en cada solicitud y se ajusta al nivel de esfuerzo, así que un nivel menor da respuestas más rápidas y económicas.

¿Qué nivel de esfuerzo debo usar?

Empieza con medium para el trabajo interactivo y la programación rutinaria, y con high para las tareas de agente difíciles y de larga duración. Pasa a xhigh donde tus evaluaciones muestren una mejora, y usa low para las llamadas sencillas de gran volumen.

¿Cómo se factura el contexto largo?

Toda la ventana de 1M tokens se factura a la tarifa estándar, así que los prompts largos cuestan lo mismo por token que los cortos. El almacenamiento en caché de prompts reduce todavía más el coste de volver a leer el contexto largo.

¿Puedo cambiar de modelo o editar mensajes en mitad de una conversación?

Puedes cambiar de modelo en cualquier momento: envía la siguiente solicitud con otro model y la API descarta automáticamente los bloques de razonamiento anteriores cuando hace falta, de modo que la solicitud se completa. En cuanto a las ediciones, mantén system y tools fijos, añade los mensajes nuevos al final y devuelve cada turno del asistente exactamente como lo recibiste; la comprobación de prefijo marca los historiales cuyos turnos anteriores cambiaron después de que se generara un bloque de razonamiento. Para cambiar las instrucciones, inicia una conversación nueva.

¿Qué diferencia hay entre Fable 5.2 y Mythos 5.2?

Comparten las mismas capacidades, especificaciones y precios. Mythos 5.2 se ofrece a organizaciones verificadas mediante los programas de Anthropic, como el Cyber Verification Program, mientras que Fable 5.2 está abierto a todos los desarrolladores.

Share: