Introduction
Claude Opus 5 est le modèle de chat phare d’Anthropic, proposé ici sous la forme d’un point de terminaison compatible OpenAI sur /v1/chat/completions. Une fenêtre de 1 000 000 de tokens transporte mot pour mot tout l’échange précédent, et une réponse peut atteindre 128 000 tokens.
L’effort de raisonnement accepte low, medium ou high, medium par défaut. Le modèle fixe lui-même son échantillonnage, temperature et top_p ne sont donc pas acceptés ; le contenu des messages se compose de texte et d’images, jusqu’à 128 outils peuvent être définis par requête, et les réponses sont diffusées en Server-Sent Events.
Fonctionnalités et points forts
Une mémoire qui se mesure en tours, pas en paragraphes
Au trentième tour, le personnage sait-il encore d’où elle vient, ce qu’elle a promis et ce qu’elle a juré de ne jamais faire ? Avec 1 000 000 de tokens en entrée, la réponse ne dépend que de ce que vous envoyez : mettez l’historique complet dans la requête, et le modèle lit les répliques d’origine, pas une paraphrase.
Un plafond de réponse de 128 000 tokens
Une seule réponse peut contenir un chapitre entier, un long rapport ou un plan de refactorisation complet. max_tokens vaut 4 096 par défaut et le raisonnement est lui aussi facturé en sortie : relevez le plafond délibérément et gardez de la marge au-dessus de la réponse visible attendue.
Un échantillonnage fixé par le modèle
temperature et top_p ne font pas partie de cette requête, ce qui garde un corps de requête transposable d’une exécution à l’autre. Le levier dont vous disposez est l’effort de raisonnement : low pour les échanges rapides, high quand des détails semés et des faits établis doivent d’abord être réconciliés.
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, soit un huitième de la fenêtre de lecture. 4 096 par défaut ; à monter avant d’écrire un chapitre. |
reasoning_effort | Non | low, medium ou high, medium par défaut. Passez à high quand les indices semés et les faits établis doivent être recoupés avant l’écriture. |
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 $4.50 / Sortie $22.50 par 1 million de tokens
Cas d’utilisation
Une persona tenue sur des dizaines de tours
Envoyez la conversation telle qu’elle a été écrite : trente tours plus tard, le personnage sait toujours d’où elle vient, ce qu’elle a accepté et ce qu’elle refuse. La plupart des longs échanges n’ont besoin d’aucune couche de résumé.
Des agents sur de longues chaînes de tâches
Confiez le dépôt, la spécification et la discussion en cours en une seule requête, et laissez le modèle décider par quoi commencer. Un long jeu de rôle sollicite la même faculté qu’une tâche d’ingénierie en plusieurs étapes : à l’étape dix, se souvient-il encore de la décision prise à l’étape un ?
Des rapports qui doivent citer leurs sources
Chargez l’ensemble complet des documents et demandez des constats qui citent chacun le passage sur lequel ils reposent. Rien n’a été découpé avant que le modèle ne le voie : une citation manquante révèle un trou dans la matière, pas dans le pipeline.
Guide de prompt et conseils pratiques
Envoyer tout l’historique, du plus ancien au plus récent
La fenêtre est généralement plus grande que la couche de résumé que quelqu’un s’apprêtait à construire. Placez tous les messages précédents dans l’ordre dans le tableau messages et laissez le modèle lire ce qui a réellement été dit.
Persona, décor et limites dans le message système
Le message système est le seul emplacement qui ne défile jamais hors du cadre dans un long échange. Origine, manière de parler, limites fermes, personne narrative et temps du récit y ont leur place ; le message utilisateur ne porte que le tour en cours.
Imposer un appel d’outil pour une sortie lisible par machine
Ce point de terminaison n’a pas de response_format, et une conversation ne peut pas se terminer par un message assistant pour préremplir la réponse. Définissez un outil dont les paramètres sont le schéma JSON voulu, pointez tool_choice vers cette fonction et validez les arguments ; un max_tokens supérieur à 128 000 et les parties vidéo et audio sont refusés.
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-opus-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.
