Introduction
Claude Fable 5 est le modèle de chat d’Anthropic orienté récit, proposé ici sous la forme d’un point de terminaison compatible OpenAI sur /v1/chat/completions. Il lit jusqu’à 1 000 000 de tokens par requête et écrit jusqu’à 128 000 tokens en une seule réponse : de quoi renvoyer mot pour mot la transcription entière d’un jeu de rôle et recevoir un chapitre complet.
Le contenu des messages se compose de texte et d’images. L’effort de raisonnement accepte low, medium ou high (medium par défaut), jusqu’à 128 définitions d’outils voyagent dans le même appel, et la réponse peut être diffusée en Server-Sent Events. L’échantillonnage est fixé par le modèle : temperature et top_p ne font donc pas partie de la requête.
Fonctionnalités et points forts
Un million de tokens pour l’histoire déjà écrite
Une longue session échoue rarement parce que la prose se dégrade ; elle échoue quand un personnage oublie une promesse faite trente tours plus tôt. Avec 1 000 000 de tokens en entrée, vous envoyez la transcription telle qu’elle a été écrite plutôt qu’un résumé, et la réplique qui ne comptera que plus tard est toujours là le moment venu.
Des réponses de la longueur d’un chapitre
max_tokens monte jusqu’à 128 000, pour une valeur par défaut de 4 096. Augmentez-le délibérément quand vous voulez un chapitre entier d’un seul jet : une scène écrite en une génération garde sa personne, son temps et son rythme, alors que des fragments recousus dérivent aux jointures.
Un effort réglé à chaque requête
low, medium et high tiennent dans une seule chaîne du corps de requête, medium par défaut. Passez à high pour une scène qui doit réconcilier des détails semés et des faits établis, et à low pour de courts échanges où la vitesse compte plus que la réflexion.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
messages | Oui | Tours de conversation ordonnés. Le contenu est une chaîne ou un tableau de parties text et |
max_tokens | Non | Plafonne la réponse à 128 000 ; la valeur par défaut est 4 096. Relevez-la quand la demande porte sur un chapitre entier et non sur une amorce. |
reasoning_effort | Non | low, medium ou high ; medium est le défaut. Le niveau haut consacre plus de temps à tenir la continuité sur des dizaines de tours. |
stop | Non | Jusqu’à 4 séquences, sous forme de chaîne ou de tableau. La réponse s’arrête dès que le modèle en écrit une, et le texte correspondant n’est pas renvoyé. 1 caractères minimum · 1 éléments minimum · 4 éléments maximum |
tools | Non | Jusqu’à 128 définitions de fonctions par requête. 128 éléments maximum |
parallel_tool_calls | Non | true ou false, true par défaut : le modèle peut demander plusieurs appels d’outils dans un même tour. Valeur par défaut: |
tool_choice | Non | auto, none, required, ou un objet qui nomme une fonction. |
Tarification
Entrée $9 / Sortie $45 par 1 million de tokens
Cas d’utilisation
Un personnage sur cinquante tours
Placez la persona et les faits acquis dans le message système, et tout le texte antérieur dans l’historique. Ce que le personnage a juré, refusé ou laissé échapper est relu dans sa formulation d’origine à chaque tour, au lieu d’être reconstitué à partir d’un simple rappel.
Scènes chorales
Quatre personnages dans une même pièce, chacun avec sa diction, ses tics de langage et ses tabous déjà consignés. Renvoyez la scène entière pour la poursuivre : chaque voix reste attachée à celui qui parle au lieu de se fondre dans un registre commun.
Fiction feuilletonnée, un chapitre par appel
Envoyez l’histoire jusqu’ici et demandez le chapitre suivant, avec un max_tokens relevé en conséquence. Une seule longue génération n’a pas de coutures à reprendre, ce qui vous épargne la passe de révision qu’exige d’ordinaire un texte assemblé.
Guide de prompt et conseils pratiques
Envoyer le texte antérieur, pas un résumé
Un résumé garde ce qui semblait important sur le moment, et dans une fiction longue c’est rarement le détail dont vous aurez besoin plus tard. Mettez l’historique dans le tableau messages, du plus ancien au plus récent, et gardez la voix, le point de vue et les limites dans le message système.
Écrire les faits acquis sous forme de liste courte
La lettre n’a jamais été envoyée ; la dette est due au frère cadet ; le narrateur ne prononce jamais le prénom de la sœur. Trois lignes dans le message système se ratent moins facilement que trois faits enfouis 200 000 tokens plus haut.
Anticiper les limites de la requête
Un max_tokens supérieur à 128 000 échoue à la validation, et les résultats d’outils partagent la même fenêtre que la prose. Les parties vidéo et audio sont refusées, et une conversation ne peut pas se terminer par un message assistant pour préremplir la réponse. Pour une sortie lisible par machine, définissez un outil dont les paramètres sont votre schéma JSON et imposez-le avec tool_choice.
Démarrage rapide de l’API
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "anthropic/claude-fable-5/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
