Nota del autor: este artículo explica la diferencia entre el effort por defecto de Fable en Claude Code (Medium) y el de Fable 5.2 en la API cuando no se indica effort (high), y cómo alinear el consumo de ambos lados en las llamadas a la API.
Muchos desarrolladores empiezan usando Fable 5.2 en Claude Code para programar y ven que el consumo de tokens es bastante contenido. Luego llaman al mismo ID de modelo por la API, notan que el consumo en tareas similares sube de forma evidente y sospechan que ambos lados no ejecutan el mismo modelo. Aquí va la conclusión: el effort por defecto de la aplicación de Claude y de Claude Code es Medium, mientras que en la API de Claude, si no indicas effort, el valor por defecto de Fable 5.2 es high.
No son dos modelos distintos, ni hay un problema de facturación. La diferencia viene del valor por defecto de un mismo parámetro según el punto de entrada. Anthropic lo dejó claro en el anuncio del 2026-11-09, en la página del modelo de la plataforma Claude y en la documentación de Effort.
Lo que te llevas: al terminar el artículo sabrás por qué el consumo de Claude Code y el de la API no cuadran, y cómo configurar el effort de forma explícita en tus solicitudes a la API para que la comparación de costes se haga sobre el mismo nivel.
Puntos clave: Fable usa Medium por defecto en Claude Code y la API usa high
Primero, una tabla con la diferencia entre las dos vías de acceso. Toda la información de esta tabla sale del anuncio oficial, la página del modelo y la documentación de Effort.
| Punto clave | Explicación | Qué implica para ti |
|---|---|---|
| Claude Code usa Medium por defecto | El anuncio oficial indica que Medium es el nivel de effort por defecto en la aplicación de Claude y en Claude Code | El consumo que ves en Claude Code corresponde al nivel Medium |
| La API usa high por defecto | En la tabla comparativa de la página del modelo, el Default effort de Fable 5.2 es high, y se refiere al valor por defecto del parámetro effort en la API de Claude | Si tu solicitud a la API no incluye effort, se ejecuta en high |
| Es el mismo modelo | En ambos lados se invoca Fable 5.2; solo cambia el nivel de effort | No interpretes la diferencia de consumo como una diferencia de versión del modelo |
| Niveles disponibles | Fable 5.2 admite low, medium, high, xhigh y max | En la API puedes fijar medium de forma explícita para igualarlo con Claude Code |
Por qué el consumo de Fable no es igual en Claude Code y en la API
El parámetro effort controla cuánto razonamiento y cuánta salida dedica el modelo a una tarea. Cuanto más alto es el nivel, más a fondo suele pensar y desarrollar el modelo, y más tokens tiende a consumir. Con niveles más bajos, el modelo tiende a responder más rápido y gastando menos. Claude Code está pensado para la interacción diaria de programación, y elige Medium por defecto para equilibrar resultados y consumo.
La API de Claude es la interfaz que los desarrolladores integran directamente. En la API, el valor por defecto de effort para Fable 5.2 es high: si el cuerpo de la solicitud no incluye el parámetro effort, el servidor la procesa como high. Mucha gente, al pasar de Claude Code a la API, solo cambia la base_url y el ID del modelo, sin añadir effort, así que el nivel real de ejecución sube de Medium a high.
Lo que dice oficialmente Anthropic sobre Fable 5.2 con Medium por defecto
En el anuncio del 2026-11-09, Anthropic menciona que, en el nivel por defecto Medium, Fable 5.2 usa menos tokens que 5.1 para completar tareas difíciles. Esto es una afirmación de la propia empresa, no una conclusión de pruebas de terceros. La frase habla de la eficiencia del nivel Medium, pero no da un múltiplo único de cuánto más consume high frente a Medium.
Por eso, no tomes como cifra fija que high cuesta tantas veces más que Medium. La complejidad de la tarea, la longitud del contexto y la longitud de la salida influyen en la diferencia real. Lo único fiable es ejecutar tu propia tarea con medium y con high, y comparar el campo usage.
Comparación de los niveles de effort de Fable 5.2 con el Medium predeterminado de Claude Code
La siguiente tabla muestra los cinco niveles que admite Fable 5.2 y cómo se relacionan con los valores predeterminados de los dos puntos de acceso. La orientación de cada nivel corresponde al significado general del parámetro effort; el comportamiento concreto dependerá de lo que devuelva realmente tu tarea.
| Nivel de effort | ¿Es el predeterminado de algún punto de acceso? | Orientación general | Tareas adecuadas |
|---|---|---|---|
low |
No | Más rápido y económico, con poco esfuerzo de razonamiento | Reescrituras simples, conversión de formato, clasificación |
medium |
Predeterminado en la aplicación de Claude y en Claude Code | Equilibrio entre resultado y consumo | Programación del día a día, preguntas y respuestas habituales, procesamiento por lotes |
high |
Predeterminado en la API de Claude (cuando no se indica) | Razonamiento más completo, con tendencia a un mayor consumo | Depuración compleja, análisis de arquitectura |
xhigh |
No | Más esfuerzo que high |
Razonamiento de varios pasos de dificultad alta |
max |
No | Máximo esfuerzo | Pocas tareas críticas que exigen una calidad muy alta |
Lo importante de esta tabla son las dos filas del medio. La idea que te has formado del consumo en Claude Code viene de medium, mientras que la API, cuando no le pasas el parámetro, funciona con high. Si quieres reproducir la experiencia y el coste de Claude Code, tus solicitudes a la API deberían indicar medium de forma explícita.
Cómo alinear Fable 5.2 con el nivel Medium por defecto de Claude Code en la API
Los pasos de abajo no incluyen bloques de código, así que puedes revisarlos en orden. Para saber cómo se escribe exactamente el campo effort en el cuerpo de la solicitud, consulta la documentación de Effort de la plataforma Claude y la documentación de la interfaz de la plataforma que uses.
Paso 1: Confirma el ID del modelo y la dirección de acceso
- En la página de precios de modelos de APIYI, docs.apiyi.com/models, busca el ID de modelo que corresponde a Fable 5.2:
claude-fable-5-2 - Para la dirección de la interfaz, usa el base_url compatible con OpenAI:
https://api.apiyi.com/v1 - Con la misma clave API puedes hacer las llamadas; no necesitas abrir una cuenta aparte para Claude
Paso 2: Rellena el parámetro effort de forma explícita
- Si quieres coincidir con Claude Code: configura effort en
medium - Si necesitas un razonamiento más potente: configúralo en
high, que además es el valor por defecto cuando no se indica nada - Si solo vas a hacer conversiones sencillas: puedes probar con
lowpara reducir el consumo - No te fíes del valor por defecto; si no, en los logs no podrás saber con qué nivel se ejecutó cada solicitud
Paso 3: Compara el consumo de ambos niveles con el campo usage
- Elige un mismo lote de tareas y ejecútalo una vez con
mediumy otra conhigh - Anota los tokens de entrada, los tokens de salida y los tokens de lectura de caché que devuelve cada llamada
- Convierte el consumo en costo según el precio unitario y obtén la diferencia real en tu caso de uso, en lugar de aplicar un múltiplo fijo
🚀 Inicio rápido: si quieres comprobar primero cómo influye el nivel de effort en el consumo, puedes usar el crédito de prueba gratuito para usuarios nuevos en APIYI (apiyi.com) y lanzar una comparativa entre medium y high. Con una sola clave la plataforma da acceso a modelos como Claude, OpenAI o Gemini, así que si después quieres comparar con otros modelos no tendrás que cambiar la forma de conectarte.
Relación entre el precio de la API de Fable 5.2 y el uso de effort
El nivel de effort no cambia el precio unitario; lo que modifica es cuántos tokens consume cada solicitud. Por tanto, la diferencia de costo equivale a la diferencia en cantidad de tokens multiplicada por el precio unitario. La tabla siguiente muestra los datos de la página de precios de APIYI a fecha de 2026-11-11.
| ID del modelo | Entrada | Salida | Lectura de caché | Grupo | Fecha de los datos |
|---|---|---|---|---|---|
claude-fable-5-2 |
$8 | $40 | $0.2 | Incluye ClaudeCode | 2026-11-11 |
Las unidades de precio y los valores más recientes deben consultarse siempre en la página de precios de APIYI, docs.apiyi.com/models, que se actualiza en tiempo real. En la tabla se ve que el precio unitario de salida es 5 veces el de entrada. Al subir el nivel de effort, el modelo suele generar más razonamiento y más contenido de respuesta, y como los tokens de salida son los más caros, el sobrecosto del nivel high viene sobre todo de la parte de salida.
El precio de la lectura de caché es mucho más bajo que el de entrada. Si tus solicitudes incluyen muchas indicaciones de sistema repetidas o un contexto fijo, activar la caché reduce de forma notable el costo del lado de entrada. Eso sí, la caché solo afecta a la entrada y no compensa el aumento de salida que provoca subir el effort.
Cómo estimar correctamente el costo de Fable 5.2
Al estimar costos, no uses frases como «high cuesta tantas veces más que Medium» para calcular el presupuesto. La documentación oficial solo indica los valores predeterminados de los dos puntos de entrada y la conclusión, autodeclarada por el fabricante, de que en el nivel Medium Fable 5.2 ahorra más tokens que la 5.1. No ofrece una proporción de conversión unificada entre high y Medium.
Lo más fiable es tomar entre 20 y 50 tareas reales y representativas, ejecutarlas en ambos niveles y calcular el promedio de tokens de entrada, salida y lectura de caché. Después, con los precios unitarios de la tabla anterior, calcula el costo medio por tarea y obtendrás cifras aplicables a tu propio negocio.
Guía de diagnóstico cuando el consumo de Fable 5.2 no cuadra
Si notas que el consumo de la API y el de Claude Code difieren mucho, puedes revisar los puntos de la siguiente tabla uno por uno.
| Síntoma | Posible causa | Qué hacer |
|---|---|---|
| El consumo de la API es claramente mayor que el de Claude Code | La solicitud no incluye effort, así que se ejecuta con el valor predeterminado high |
Configúralo explícitamente como medium y vuelve a comparar |
| Has indicado effort pero el consumo no cambia | La posición o el nombre del campo no cumple con lo que exige la interfaz y se ignora | Revisa cómo se escribe el campo en la documentación de Effort y en la documentación de la interfaz de la plataforma |
| La solicitud devuelve un error de parámetros | El valor de effort no está dentro del rango admitido | Usa solo low, medium, high, xhigh o max |
| Error con el nombre del modelo | El ID del modelo está mal escrito | Comprueba claude-fable-5-2 en la página de precios de APIYI |
| Ambos lados están en medium y aun así el consumo es distinto | Difieren la longitud del contexto, las llamadas a herramientas y los aciertos de caché | Fija el contenido de entrada antes de comparar y mira por separado los tokens de lectura de caché |
La última fila es fácil de pasar por alto. Mientras programas, Claude Code incorpora automáticamente el contenido de los archivos y el historial de la conversación, mientras que la solicitud a la API que escribes tú no necesariamente incluye tanto contexto. Aunque el effort sea el mismo, los tokens de entrada pueden ser distintos, así que lo mejor es fijar la entrada cuando hagas la comparación.
Preguntas frecuentes (FAQ)
P1: ¿El Fable de Claude Code y el Fable 5.2 de la API son el mismo modelo?
Sí, es el mismo modelo. La diferencia está en el valor por defecto del parámetro effort: la app de Claude y Claude Code usan Medium por defecto, mientras que en la API de Claude, si no indicas effort, Fable 5.2 usa high.
P2: ¿Qué pasa si no indico effort en la API?
El servidor ejecutará la solicitud con el valor por defecto de Fable 5.2 en la API de Claude, que es high. Por eso mucha gente nota que el consumo sube cuando pasa de Claude Code a la API.
P3: ¿Cuántas veces más caro es high que Medium?
La documentación oficial no da un múltiplo único. El parámetro effort no cambia el precio unitario, solo afecta al consumo de tokens, y esa diferencia depende de la dificultad de la tarea, del contexto y de la longitud de la salida. Lo recomendable es ejecutar ambos niveles con tus propias tareas y calcular el coste con los datos de usage.
P4: ¿Qué niveles de effort admite Fable 5.2?
Según la documentación de Effort, Fable 5.2 admite cinco niveles: `low`, `medium`, `high`, `xhigh` y `max`. Para programación del día a día, `medium` suele bastar; para razonamiento complejo, considera subir de nivel.
P5: ¿Cómo invoco Fable 5.2 por API y configuro effort?
Puedes seguir estos tres pasos:
1. Regístrate en APIYI (apiyi.com) y obtén tu clave API; los usuarios nuevos reciben crédito gratuito para pruebas.
2. Usa `https://api.apiyi.com/v1` como base_url y `claude-fable-5-2` como ID del modelo.
3. Indica effort de forma explícita en la solicitud; el nombre exacto del campo debe seguir lo que digan la documentación de Effort y la documentación de la interfaz de la plataforma.
P6: ¿Cuál es el precio de Fable 5.2 en APIYI?
Según la lista de precios del 2026-11-11, `claude-fable-5-2` cuesta $8 de entrada, $40 de salida y $0.2 por lectura de caché, y el grupo incluye ClaudeCode. Los precios pueden cambiar, así que antes de contratar consulta los datos en tiempo real de la página de precios de APIYI.
P7: En el nivel Medium, Fable 5.2 gasta menos tokens que la 5.1. ¿Es fiable esa conclusión?
Es una afirmación oficial de Anthropic, publicada el 2026-11-09, y describe el rendimiento global en tareas difíciles. No aporta cifras comparativas entre high y Medium. Si el coste te importa, sigue siendo conveniente que lo verifiques con los datos de tus propias tareas.
P8: ¿Debería cambiar todas las solicitudes a la API a medium?
No necesariamente. Si quieres reproducir la experiencia y el coste de Claude Code, `medium` es suficiente. Para depuración compleja o análisis críticos puedes mantener `high`, y para tareas sencillas puedes bajar a `low`. Lo importante es indicar el nivel de forma explícita y no dejar que el valor por defecto decida por ti.
Puntos clave: Fable en Claude Code usa Medium por defecto y la API usa high
- Mismo modelo, distinto valor por defecto: Claude Code usa Medium por defecto, mientras que en la API, si no indicas effort, Fable 5.2 usa high
- Sin parámetro, se ejecuta en high: al migrar a la API, olvidar incluir effort es la causa más común de que aumente el consumo
- Cinco niveles disponibles: Fable 5.2 admite low, medium, high, xhigh y max
- No hay un múltiplo fijo: la documentación oficial no da una proporción de conversión única entre high y Medium, así que tienes que calcularla con los datos de tus propias tareas
- El costo depende de la salida: el precio unitario de salida es 5 veces el de entrada, así que el incremento al subir effort viene sobre todo de los tokens de salida
- Empezar es sencillo: con la interfaz compatible con OpenAI de APIYI y el ID de modelo
claude-fable-5-2, ya puedes comparar niveles
Resumen
Sobre el hecho de que Fable use Medium por defecto en Claude Code y high en la API cuando no se indica nada, quédate con tres ideas:
- Los valores por defecto son distintos: la aplicación de Claude y Claude Code usan Medium por defecto, mientras que en la API de Claude, Fable 5.2 usa high
- Define effort de forma explícita: si quieres igualar el comportamiento de Claude Code, escribe
mediumen tu solicitud a la API - Estima el costo con datos: no apliques un múltiplo fijo; usa el campo usage y los precios unitarios para calcular la diferencia real en tu caso
Como siguiente paso, te recomiendo elegir un conjunto de tareas reales y ejecutarlas tanto en medium como en high, y luego incorporar los resultados a tu modelo de costos. Puedes hacer esta comparación primero en apiyi.com con el crédito gratuito de APIYI y después decidir qué nivel dejar por defecto en producción.
📚 Referencias
- Publicación de Anthropic: notas de lanzamiento de Fable y Mythos 5.2, 2026-11-09
- Enlace:
anthropic.com/claude-fable-and-mythos-5-2 -
Descripción: origen del nivel Medium effort como valor por defecto en la aplicación de Claude y en Claude Code, además de los datos oficiales (autoinformados) que indican que, con Medium, se consumen menos tokens que con la 5.1
-
Página del modelo Fable 5.2: tabla comparativa de parámetros del modelo
- Enlace:
platform.claude.com/docs/en/models/fable-5-2/overview -
Descripción: el Default effort es high, es decir, el valor por defecto del parámetro effort en la API de Claude
-
Documentación de Effort: explicación del parámetro effort
- Enlace:
platform.claude.com/docs/en/build-with-claude/effort -
Descripción: niveles que admite Fable 5.2 y valor por defecto de la API
-
Página de precios de modelos de APIYI: ID de modelo y precios
- Enlace:
docs.apiyi.com/models - Descripción: precios de entrada, salida y lectura de caché de
claude-fable-5-2, junto con la información de grupos. Datos a fecha de 2026-11-11
Autor: equipo técnico de APIYI
Soporte técnico: si tienes dudas sobre la configuración de effort o la comparación de uso, escríbenos desde la página principal de APIYI.
