Note de l’auteur : cet article explique la différence entre l’effort par défaut de Fable dans Claude Code (Medium) et celui de Fable 5.2 dans l’API quand on ne renseigne pas effort (high). Il montre aussi comment aligner la consommation des deux côtés dans vos appels API.
Beaucoup de développeurs commencent par utiliser Fable 5.2 dans Claude Code pour coder, et trouvent la consommation de tokens plutôt raisonnable. Puis ils appellent le même ID de modèle via l’API, constatent que des tâches comparables consomment nettement plus, et se demandent si les deux côtés font vraiment tourner le même modèle. Voici la réponse : l’effort par défaut de l’application Claude et de Claude Code est Medium, alors que dans l’API Claude, Fable 5.2 utilise high lorsque vous ne renseignez pas effort.
Il ne s’agit ni de deux modèles différents, ni d’un problème de facturation : la différence vient de la valeur par défaut d’un même paramètre selon le point d’entrée. Anthropic l’indique explicitement dans son annonce du 2026-11-09, ainsi que sur la page du modèle et dans la documentation sur Effort de la plateforme Claude.
L’essentiel : après cette lecture, vous saurez pourquoi la consommation de Claude Code et celle de l’API ne coïncident pas, et comment définir explicitement effort dans vos requêtes API pour comparer les coûts des deux côtés à niveau égal.
Claude Code : Fable en Medium par défaut, API en high par défaut — l’essentiel
Commençons par un tableau qui résume la différence entre les deux points d’entrée. Toutes les informations viennent de l’annonce officielle, de la page du modèle et de la documentation sur l’effort (effort).
| Point clé | Explication | Ce que ça change pour vous |
|---|---|---|
| Claude Code : Medium par défaut | L’annonce officielle précise que l’effort Medium est le réglage par défaut de l’application Claude et de Claude Code | La consommation que vous voyez dans Claude Code correspond au niveau Medium |
| API : high par défaut | Dans le tableau comparatif de la page du modèle, l’effort par défaut de Fable 5.2 est high ; il s’agit de la valeur par défaut du paramètre effort sur l’API Claude | Une requête API sans effort s’exécute en high |
| Un seul et même modèle | Les deux côtés appellent Fable 5.2 ; seul le niveau d’effort diffère | Ne mettez pas l’écart de consommation sur le compte d’une différence de version du modèle |
| Niveaux disponibles | Fable 5.2 prend en charge low, medium, high, xhigh et max | Vous pouvez fixer explicitement medium sur l’API pour vous aligner sur Claude Code |
Pourquoi la consommation de Fable diffère entre Claude Code et l’API
Le paramètre effort contrôle la quantité de raisonnement et de sortie que le modèle investit dans une tâche. Plus le niveau est élevé, plus le modèle réfléchit et développe en profondeur, et plus il tend à consommer de tokens. À l’inverse, un niveau bas pousse le modèle à répondre plus vite et plus sobrement. Claude Code est pensé pour le codage au quotidien : il choisit Medium par défaut, un compromis entre qualité et consommation.
L’API Claude, elle, s’adresse aux développeurs qui l’intègrent directement. Sur l’API, la valeur par défaut de l’effort pour Fable 5.2 est high : dès que le corps de la requête ne contient pas le paramètre effort, le serveur traite la demande en high. Beaucoup de gens qui passent de Claude Code à l’API se contentent de changer la base_url et l’identifiant du modèle, sans reprendre l’effort. Résultat : le niveau réellement utilisé passe de Medium à high.
Ce que dit officiellement Anthropic sur Fable 5.2 en Medium
Dans son annonce du 2026-11-09, Anthropic indique qu’au niveau par défaut Medium, Fable 5.2 utilise moins de tokens que la 5.1 pour venir à bout de tâches difficiles. C’est une déclaration officielle, pas le résultat d’un test indépendant. Elle éclaire l’efficacité du niveau Medium, mais elle ne donne aucun coefficient général sur la surconsommation de high par rapport à Medium.
Ne retenez donc pas « high coûte X fois plus que Medium » comme un chiffre fixe. La complexité de la tâche, la longueur du contexte et celle de la sortie influencent toutes l’écart réel. La seule méthode fiable consiste à lancer vos propres tâches en medium puis en high, et à comparer le champ usage.
Fable 5.2 : les niveaux d’effort face au Medium par défaut de Claude Code
Le tableau ci-dessous liste les cinq niveaux pris en charge par Fable 5.2, ainsi que leur lien avec les valeurs par défaut des deux points d’entrée. L’orientation de chaque niveau correspond à la signification générale du paramètre effort ; le comportement réel dépend de ce que renvoie votre tâche.
| Niveau d’effort | Défaut d’un point d’entrée ? | Orientation générale | Tâches adaptées |
|---|---|---|---|
low |
Non | Plus rapide, plus économe, peu d’effort de raisonnement | Reformulation simple, conversion de format, classification |
medium |
Défaut de l’application Claude et de Claude Code | Équilibre entre qualité et consommation | Codage au quotidien, questions-réponses courantes, traitement par lots |
high |
Défaut de l’API Claude (quand le paramètre n’est pas renseigné) | Raisonnement plus poussé, consommation plutôt plus élevée | Débogage complexe, analyse d’architecture |
xhigh |
Non | Plus d’effort que high |
Raisonnement en plusieurs étapes de difficulté élevée |
max |
Non | Effort maximal | Un petit nombre de tâches critiques, avec des exigences de qualité très élevées |
Ce qu’il faut retenir de ce tableau, ce sont surtout les deux lignes du milieu. L’impression de consommation que vous vous êtes faite dans Claude Code vient de medium, alors que l’API, sans paramètre, fonctionne en high. Si vous voulez retrouver l’expérience et le coût de Claude Code, indiquez donc explicitement medium dans vos requêtes API.
Comment aligner Fable 5.2 sur le niveau Medium par défaut de Claude Code via l’API
Les étapes ci-dessous ne contiennent pas de code : il suffit de les suivre dans l’ordre. Pour la syntaxe exacte du champ effort dans le corps de la requête, référez-vous à la documentation Effort de la plateforme Claude et à la documentation de l’interface de la plateforme que vous utilisez.
Étape 1 : vérifier l’ID du modèle et l’adresse d’accès
- Sur la page des tarifs des modèles d’APIYI, docs.apiyi.com/models, repérez l’ID du modèle Fable 5.2 :
claude-fable-5-2 - Pour l’adresse de l’interface, utilisez la base_url compatible OpenAI :
https://api.apiyi.com/v1 - Une seule clé API suffit pour l’invocation du modèle, inutile de créer un compte séparé pour Claude
Étape 2 : renseigner explicitement le paramètre effort
- Pour rester cohérent avec Claude Code : réglez effort sur
medium - Pour un raisonnement plus poussé : passez à
high, qui est aussi la valeur par défaut quand rien n’est précisé - Pour de simples conversions : essayez
lowafin de réduire la consommation - Ne comptez pas sur la valeur par défaut, sinon vos logs ne vous diront pas à quel niveau la requête a tourné
Étape 3 : comparer la consommation des deux niveaux avec le champ usage
- Prenez un même lot de tâches et lancez-le une fois en
medium, puis une fois enhigh - Notez à chaque fois les tokens d’entrée, les tokens de sortie et les tokens lus depuis le cache
- Convertissez en coût selon le prix unitaire : vous obtiendrez l’écart réel pour votre propre usage, plutôt qu’un multiplicateur fixe appliqué à l’aveugle
🚀 Pour démarrer : si vous voulez d’abord mesurer l’effet du niveau d’effort sur la consommation, vous pouvez utiliser le crédit de test gratuit offert aux nouveaux utilisateurs d’APIYI (apiyi.com) pour lancer une comparaison medium et high. Une seule clé donne accès à Claude, OpenAI, Gemini et d’autres modèles : si vous voulez comparer avec un autre modèle par la suite, vous n’aurez rien à changer dans votre façon de vous connecter.
Relation entre le prix de l’API Fable 5.2 et l’usage d’effort
L’effort ne modifie pas le prix unitaire : il influe sur le nombre de tokens consommés par une requête. L’écart de coût correspond donc à l’écart de tokens multiplié par le prix unitaire. Le tableau ci-dessous reprend les données de la page des tarifs d’APIYI au 2026-11-11.
| ID du modèle | Entrée | Sortie | Lecture du cache | Groupe | Date des données |
|---|---|---|---|---|---|
claude-fable-5-2 |
$8 | $40 | $0.2 | Inclus dans ClaudeCode | 2026-11-11 |
Pour l’unité de prix et les valeurs les plus récentes, référez-vous à l’affichage en temps réel de la page des tarifs d’APIYI : docs.apiyi.com/models. On voit dans le tableau que le prix unitaire de sortie est 5 fois celui de l’entrée. Quand on monte le niveau d’effort, le modèle produit souvent davantage de raisonnement et de contenu de réponse, et comme le token de sortie est le plus cher, le surcoût du niveau high vient principalement de la partie sortie.
Le prix de lecture du cache est bien inférieur à celui de l’entrée. Si vos requêtes contiennent beaucoup d’invites système répétées ou de contexte fixe, activer le cache peut réduire nettement le coût côté entrée. En revanche, le cache n’agit que sur l’entrée : il ne compense pas la hausse de sortie liée à un effort plus élevé.
La bonne méthode pour estimer le coût avec Fable 5.2
Pour estimer vos coûts, ne calculez pas votre budget à partir d’un « high coûte X fois plus que Medium ». Officiellement, on ne trouve que les valeurs par défaut des deux points d’entrée, ainsi qu’une conclusion auto-déclarée selon laquelle, au niveau Medium, Fable 5.2 consomme moins de tokens que la 5.1. Aucun ratio de conversion unifié entre high et Medium n’est donné.
Une approche plus fiable consiste à prendre 20 à 50 tâches réelles représentatives, à les exécuter une fois à chaque niveau, puis à relever la moyenne des tokens d’entrée, de sortie et de lecture du cache. Il suffit ensuite d’appliquer les prix unitaires du tableau ci-dessus pour calculer le coût moyen par tâche : vous obtenez ainsi des chiffres adaptés à votre propre activité.
Fable 5.2 : que vérifier quand la consommation ne colle pas
Si vous constatez un gros écart entre la consommation de l’API et celle de Claude Code, vous pouvez passer en revue les points du tableau ci-dessous, un par un.
| Symptôme | Cause possible | Solution |
|---|---|---|
| La consommation de l’API est nettement supérieure à celle de Claude Code | L’effort n’est pas renseigné dans la requête, qui s’exécute donc avec la valeur par défaut high |
Le définir explicitement sur medium, puis refaire la comparaison |
| L’effort est renseigné, mais la consommation ne change pas | L’emplacement ou le nom du champ ne respecte pas les exigences de l’interface, il est donc ignoré | Vérifier la syntaxe du champ en vous appuyant sur la documentation Effort et sur celle de l’interface de la plateforme |
| La requête renvoie une erreur de paramètre | La valeur d’effort n’est pas dans la plage prise en charge | N’utiliser que low, medium, high, xhigh ou max |
| Erreur sur le nom du modèle | L’ID du modèle est mal orthographié | Vérifier claude-fable-5-2 sur la page des tarifs d’APIYI |
| Les deux côtés sont réglés sur medium, mais la consommation diffère encore | La longueur du contexte, les appels d’outils et les succès de cache ne sont pas les mêmes | Figer le contenu d’entrée avant de comparer, et examiner séparément les tokens lus depuis le cache |
La dernière ligne est facile à négliger. Pendant le codage, Claude Code injecte automatiquement le contenu des fichiers et l’historique de la conversation, alors que les requêtes API que vous écrivez vous-même n’embarquent pas forcément autant de contexte. Même avec un effort identique, les tokens d’entrée peuvent donc différer : pour comparer proprement, mieux vaut figer l’entrée.
FAQ – Questions fréquentes
Q1 : Le Fable de Claude Code et le Fable 5.2 de l’API, c’est le même modèle ?
Oui, c’est le même modèle. La différence tient à la valeur par défaut du paramètre effort : l’application Claude et Claude Code utilisent Medium par défaut, alors que sur l’API Claude, Fable 5.2 utilise high quand on ne renseigne pas effort.
Q2 : Que se passe-t-il si je ne renseigne pas effort dans l’API ?
Le serveur applique la valeur par défaut de Fable 5.2 sur l’API Claude, c’est-à-dire high. C’est justement ce qui explique pourquoi beaucoup de gens constatent une consommation plus élevée après être passés de Claude Code à l’API.
Q3 : high coûte combien de fois plus cher que Medium ?
Il n’existe pas de multiplicateur officiel unique. Le paramètre effort ne change pas le prix unitaire, il agit uniquement sur la consommation de tokens, et l’écart dépend de la difficulté de la tâche, du contexte et de la longueur de la sortie. Le mieux est de lancer vos propres tâches sur les deux niveaux et de calculer la différence à partir des données `usage`.
Q4 : Quels niveaux d’effort Fable 5.2 prend-il en charge ?
D’après la documentation Effort, Fable 5.2 prend en charge cinq niveaux : `low`, `medium`, `high`, `xhigh` et `max`. Pour le codage au quotidien, `medium` suffit généralement ; on pense à monter d’un cran pour les raisonnements complexes.
Q5 : Comment appeler Fable 5.2 via l’API et régler effort ?
Voici les trois étapes à suivre :
1. Créez un compte sur APIYI (apiyi.com) et récupérez votre clé API ; les nouveaux utilisateurs bénéficient d’un crédit de test gratuit.
2. Renseignez `https://api.apiyi.com/v1` comme base_url et `claude-fable-5-2` comme ID de modèle.
3. Indiquez explicitement effort dans la requête ; le nom exact du champ est à vérifier dans la documentation Effort et dans la documentation de l’interface de la plateforme.
Q6 : Quel est le prix de Fable 5.2 sur APIYI ?
D’après la grille tarifaire au 2026-11-11, `claude-fable-5-2` coûte 8 $ en entrée, 40 $ en sortie et 0,2 $ pour la lecture du cache, et le groupe inclut ClaudeCode. Les prix peuvent évoluer : avant de passer commande, référez-vous aux données en temps réel de la page tarifaire d’APIYI.
Q7 : En Medium, Fable 5.2 consomme moins de tokens que la 5.1 : peut-on s’y fier ?
C’est une déclaration officielle d’Anthropic, issue de son article du 2026-11-09, qui décrit la performance globale sur des tâches difficiles. Elle ne fournit aucun chiffre comparant high et Medium. Si le coût vous importe vraiment, il vaut mieux valider avec les données de vos propres tâches.
Q8 : Faut-il passer toutes les requêtes API en medium ?
Pas forcément. Pour retrouver l’expérience et le coût de Claude Code, `medium` suffit. Pour du débogage complexe ou une analyse critique, vous pouvez garder `high`, et pour les tâches simples, descendre à `low`. L’essentiel est de renseigner le niveau explicitement, plutôt que de laisser la valeur par défaut décider à votre place.
Points clés : Fable par défaut en Medium dans Claude Code vs high par défaut dans l’API
- Même modèle, valeurs par défaut différentes : Claude Code utilise Medium par défaut, tandis que l’API applique high à Fable 5.2 quand vous ne renseignez pas effort
- Sans paramètre, c’est high qui tourne : en migrant vers l’API sans reprendre effort, on tombe sur la cause la plus fréquente d’une consommation en hausse
- Cinq niveaux disponibles : Fable 5.2 prend en charge low, medium, high, xhigh et max
- Pas de coefficient fixe : la documentation officielle ne donne aucun ratio de conversion unique entre high et Medium, il faut calculer à partir des données de vos propres tâches
- Le coût se joue sur la sortie : le prix unitaire de sortie vaut 5 fois celui de l’entrée, et le surcoût lié à un effort plus élevé vient surtout des tokens de sortie
- Une prise en main simple : avec l’interface compatible OpenAI d’APIYI et l’ID de modèle
claude-fable-5-2, vous pouvez comparer les niveaux sans effort
Conclusion
Concernant Fable en Medium par défaut dans Claude Code et en high par défaut dans l’API, retenez trois points :
- Des valeurs par défaut différentes : l’application Claude et Claude Code utilisent Medium par défaut, alors que sur l’API Claude, Fable 5.2 est réglé sur high
- Définir effort explicitement : pour vous aligner sur Claude Code, indiquez
mediumdans votre requête API - Estimer le coût avec vos données : n’appliquez pas de coefficient fixe, calculez votre écart réel à partir du champ usage et des prix unitaires
Pour la suite, je vous conseille de prendre un lot de tâches réelles, de les exécuter une fois en medium et une fois en high, puis d’intégrer les résultats à votre modèle de coûts. Vous pouvez commencer par faire cette comparaison avec le quota gratuit d’APIYI (apiyi.com), puis décider du niveau par défaut en production.
📚 Références
- Article de lancement d’Anthropic : notes de version de Fable et Mythos 5.2, 2026-11-09
- Lien :
anthropic.com/claude-fable-and-mythos-5-2 -
Remarque : source du niveau Medium effort comme réglage par défaut dans l’application Claude et dans Claude Code, ainsi que de l’affirmation officielle selon laquelle, en Medium, le modèle consomme moins de tokens que la 5.1
-
Page du modèle Fable 5.2 : tableau comparatif des paramètres du modèle
- Lien :
platform.claude.com/docs/en/models/fable-5-2/overview -
Remarque : le Default effort est à high, c’est-à-dire la valeur par défaut du paramètre effort sur l’API Claude
-
Documentation sur effort : description du paramètre effort
- Lien :
platform.claude.com/docs/en/build-with-claude/effort -
Remarque : les niveaux pris en charge par Fable 5.2, ainsi que la valeur par défaut de l’API
-
Page des tarifs des modèles APIYI : ID des modèles et prix
- Lien :
docs.apiyi.com/models - Remarque : tarifs d’entrée, de sortie et de lecture du cache de
claude-fable-5-2, ainsi que les informations de groupe, données datées du 2026-11-11
Auteur : l’équipe technique d’APIYI
Échanges techniques : si vous rencontrez des difficultés avec le réglage d’effort ou la comparaison de consommation, n’hésitez pas à nous contacter depuis la page d’accueil du site d’APIYI.
