Guides des modèles et des modalités21 octobre 2026Flatkey Team

API Claude Sonnet (2026) : ID de modèle, configuration, limites et code pour Sonnet 5.5

Tout pour appeler Claude Sonnet 5.5 via l'API : ID de modèle, clés, code fonctionnel, effort et réflexion, limites de débit, coûts et correctifs de migration.

API Claude Sonnet (2026) : ID de modèle, configuration, limites et code pour Sonnet 5.5

Pour utiliser l'API Claude Sonnet, créez une clé API Anthropic, puis envoyez une requête à https://api.anthropic.com/v1/messages avec l'ID de modèle claude-sonnet-5-5, le modèle Sonnet actuel, sorti le 28 septembre 2026. Il offre une fenêtre de contexte de 1M de tokens, jusqu'à 128K tokens en sortie, une réflexion adaptative activée par défaut, et coûte 2 $ par million de tokens en entrée et 10 $ par million de tokens en sortie selon la tarification officielle d'Anthropic, au 21 octobre 2026. Si vous migrez du code depuis Sonnet 4.6 ou une version antérieure, cinq paramètres qui fonctionnaient auparavant renvoient désormais une erreur 400 ; ils sont listés ci-dessous.

Ce guide s'adresse aux développeurs qui construisent un produit sur Claude : quel ID de modèle Sonnet appeler, comment obtenir une clé, du code fonctionnel en curl, Python et Node.js, les limites de débit par palier et les changements incompatibles qui piègent les migrations. Pour le détail des coûts de tous les modèles Claude, consultez notre guide des tarifs de l'API Claude.

Modèles Claude Sonnet disponibles via l'API

Modèle	ID de modèle API	Statut (21 oct. 2026)	Contexte / sortie max.	Entrée / sortie par 1M tokens	Lecture de cache
Claude Sonnet 5.5	`claude-sonnet-5-5`	Actuel, sorti le 28 sept. 2026	1M / 128K	$2 / $10	$0.10
Claude Sonnet 5	`claude-sonnet-5`	Ancien modèle (legacy)	voir la documentation	$2 / $10	$0.20
Claude Sonnet 4.6	`claude-sonnet-4-6`	Ancien modèle (legacy)	voir la documentation	$3 / $15	$0.30
Claude Sonnet 4.5	`claude-sonnet-4-5-20250929`	Obsolète, retrait le 30 nov. 2026	voir la documentation	$3 / $15	$0.30

Tarifs issus de la page de tarification d'Anthropic ; statut des modèles issu de la vue d'ensemble des modèles et de la page des dépréciations ; caractéristiques de Sonnet 5.5 issues de la fiche Sonnet 5.5, le tout vérifié le 21 octobre 2026.

Lequel appeler : utilisez claude-sonnet-5-5 pour tout nouveau projet. Il coûte autant par token que Sonnet 5, mais deux fois moins en lecture de cache (0,10 $ contre 0,20 $ par million), d'après le guide de migration. Face à Sonnet 4.6 (3 $ / 15 $), Sonnet 5.5 est moins cher par token, mais attention au tokenizer : Anthropic indique que Sonnet 5.5 produit environ 30 % de tokens en plus que Sonnet 4.6 pour le même texte. Comparez donc des volumes réels, pas seulement les prix catalogue. Les utilisateurs de Sonnet 4.5 doivent migrer avant son retrait le 30 novembre 2026.

Sonnet 5.5 en bref

Caractéristique	Valeur	Source
ID de modèle (Claude API, Google Cloud, Microsoft Foundry, Claude Platform on AWS)	`claude-sonnet-5-5`	Fiche
ID de modèle Amazon Bedrock	`anthropic.claude-sonnet-5-5`	Fiche
Fenêtre de contexte	1M de tokens	Fiche
Sortie maximale	128K tokens ; 300K sur la Batch API avec l'en-tête bêta `output-300k-2026-03-24`	Fiche
Modalités	Texte et images en entrée, texte en sortie	Fiche
Réflexion	Adaptative, activée par défaut ; réglage minimal `between_tools`	Fiche
Effort par défaut	`high`	Fiche
Date de coupure des connaissances	Juin 2026	Fiche
Retrait	Pas avant le 28 septembre 2027	Fiche

Obtenir une clé API Claude Sonnet

Connectez-vous à la Claude Console et ouvrez API keys.
Créez une clé, copiez-la une seule fois et stockez-la sous ANTHROPIC_API_KEY dans votre environnement ou votre gestionnaire de secrets.
Ajoutez du crédit ou un moyen de paiement. Le palier d'usage (et donc les limites de débit) augmente avec les dépenses ; voir la section sur les limites ci-dessous.

Une seule clé fonctionne pour tous les modèles Claude : il n'existe pas de « clé API Sonnet » distincte. Si vous préférez une clé unique pour Claude, GPT, Gemini et DeepSeek, une API unifiée comme Flatkey délivre une seule clé pour tous (détails en fin d'article).

Votre première requête Claude Sonnet 5.5

La requête ci-dessous reprend l'exemple officiel d'Anthropic dans le guide de migration Sonnet 5.5. Elle fixe un niveau d'effort et évite tous les paramètres qui renvoient une erreur 400 sur ce modèle.

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 4096,
    "messages": [{"role": "user", "content": "Write a SQL query that finds churned customers in the last 30 days."}],
    "output_config": {"effort": "medium"}
  }'

En Python, avec le SDK officiel anthropic :

# pip install anthropic
import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY

response = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=4096,
    messages=[{"role": "user", "content": "Write a SQL query that finds churned customers in the last 30 days."}],
    output_config={"effort": "medium"},
)

print("stop_reason:", response.stop_reason)
for block in response.content:
    if block.type == "text":  # adaptive thinking may add thinking blocks first
        print(block.text)

En Node.js avec @anthropic-ai/sdk :

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

const client = new Anthropic(); // reads ANTHROPIC_API_KEY

const response = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 4096,
  messages: [{ role: "user", content: "Write a SQL query that finds churned customers in the last 30 days." }],
  output_config: { effort: "medium" },
});

const text = response.content.find((b) => b.type === "text");
console.log(response.stop_reason, text?.text);

Lisez la réponse par type de bloc. Avec la réflexion adaptative, le premier bloc de contenu peut être un bloc thinking ; response.content[0].text n'est donc pas fiable sur Sonnet 5.5.

Effort et réflexion sur Sonnet 5.5

Sonnet 5.5 remplace les budgets de réflexion fixes par un réglage effort dans output_config (documentation effort). La valeur par défaut est high. Le guide de migration d'Anthropic présente les niveaux low, medium, high, xhigh et max.

Objectif	À envoyer	Remarques de la documentation Anthropic
Comportement par défaut	rien, ou `thinking: {"type": "adaptive"}`	La réflexion adaptative est activée par défaut
Réponses moins chères et plus rapides	`output_config: {"effort": "low"}` ou `"medium"`	Moins d'effort, moins de tokens en sortie
Pas de réflexion préalable	`thinking: {"type": "between_tools"}`	Accepté en `low`, `medium`, `high` ; erreur 400 en `xhigh` ou `max`
Problèmes les plus difficiles	`output_config: {"effort": "xhigh"}` ou `"max"`	Utiliser la réflexion adaptative, pas `between_tools`

thinking: {"type": "disabled"} n'est pas accepté sur Sonnet 5.5 ; between_tools est le réglage le plus bas (guide de migration).

Paramètres qui renvoient désormais une erreur 400

Si vous passez depuis Sonnet 4.6 ou antérieur, supprimez ces paramètres. Les cinq figurent dans le guide de migration Sonnet 5.5 d'Anthropic :

Ancien paramètre	Sur Sonnet 5.5	Remplacer par
`thinking: {"type": "enabled", "budget_tokens": N}`	Erreur 400	`output_config.effort`
`temperature`, `top_p`, `top_k`	Erreur 400	Consignes dans le prompt ; effort
Préremplissage de l'assistant (dernier message `assistant`)	Erreur 400	Sorties structurées ou instructions système
`tool_choice` forcé (`any` ou un outil nommé)	Erreur 400	`auto` avec des consignes claires sur les outils
`thinking: {"type": "disabled"}`	Erreur 400	`thinking: {"type": "between_tools"}`

Revérifiez aussi max_tokens et vos estimations de coût, compte tenu des quelque 30 % de tokens supplémentaires par rapport à Sonnet 4.6. En cas d'erreurs d'ID de modèle après la mise à jour, nos guides Claude : version de modèle introuvable et erreurs 400 d'Anthropic couvrent les causes fréquentes.

Limites de débit de l'API Claude Sonnet

Anthropic publie les limites par palier sur sa page des limites de débit. Pour Sonnet 5.5, au 21 octobre 2026 :

Palier	Requêtes par minute	Tokens d'entrée par minute	Tokens de sortie par minute
Start	1 000	2 000 000	400 000
Build	5 000	5 000 000	1 000 000
Scale	10 000	10 000 000	2 000 000

Sonnet 5, Sonnet 4.x et Haiku 5.5 partagent les mêmes valeurs par palier. Anthropic précise que, pour la plupart des modèles, les tokens d'entrée lus depuis le cache ne comptent pas dans la limite de tokens d'entrée par minute : le prompt caching sert donc autant à réduire les coûts qu'à desserrer les limites.

Ce que coûte réellement Sonnet 5.5

Tarifs officiels au 21 octobre 2026, par million de tokens (tarification) :

Poste	Prix
Entrée	$2.00
Sortie	$10.00
Écriture en cache, 5 minutes	$2.50
Écriture en cache, 1 heure	$4.00
Lecture de cache	$0.10
Batch API entrée / sortie	$1.00 / $5.00
Inférence limitée aux États-Unis (`inference_geo`)	1,1x sur tous les prix de tokens

Exemple chiffré : un assistant de support traitant 50 000 requêtes par mois, chacune avec un prompt système en cache de 3 000 tokens, 500 nouveaux tokens d'entrée et 400 tokens de sortie. Lectures de cache : 150M tokens × 0,10 $ = 15 $. Nouvelle entrée : 25M × 2 $ = 50 $. Sortie : 20M × 10 $ = 200 $. Total : environ 265 $ par mois, hors écritures ponctuelles en cache. La sortie domine, d'où l'importance de effort plutôt que de l'optimisation de l'entrée. Pour comparer modèle par modèle, voir tarifs de l'API Claude et routage API Claude vs GPT.

Utiliser Claude Sonnet avec le SDK OpenAI

Anthropic propose un endpoint compatible OpenAI à https://api.anthropic.com/v1/, mais sa page de compatibilité avec le SDK OpenAI le présente comme destiné aux tests et comparaisons, pas à la plupart des usages en production : le paramètre strict du function calling est ignoré, response_format est ignoré et le prompt caching n'est pas pris en charge. En production sur Sonnet 5.5, utilisez la Messages API native présentée plus haut. Notre article sur la compatibilité de l'API Claude avec le SDK OpenAI détaille les options.

Une seule clé pour Sonnet et les autres modèles : Flatkey

Si votre produit appelle aussi GPT, Gemini ou DeepSeek, Flatkey vous donne une seule clé et un seul solde prépayé pour tous. Le 21 octobre 2026, la page du modèle Claude Sonnet 5.5 chez Flatkey affichait 1,60 $ en entrée / 8,00 $ en sortie par million de tokens, soit 20 % de moins que les 2 $ / 10 $ d'Anthropic, et Sonnet 4.6 à 2,40 $ / 12,00 $. Le SDK Anthropic fonctionne en remplaçant la base URL par https://router.flatkey.ai (sans /v1), selon le guide du SDK Anthropic de Flatkey :

import anthropic

client = anthropic.Anthropic(api_key="YOUR_FLATKEY_KEY", base_url="https://router.flatkey.ai")
msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Draft a release note for v2.3."}],
)
print(next(b.text for b in msg.content if b.type == "text"))

Pour Claude Code, voir la configuration du routeur API pour Claude Code. Passez directement par Anthropic si vous avez besoin de fonctionnalités ou de contrats propres à sa plateforme, comme certains en-têtes bêta le jour du lancement ou un accord entreprise.

FAQ

Quel est le nom du modèle de l'API Claude Sonnet ?

L'ID actuel est claude-sonnet-5-5 sur Claude API, Google Cloud, Microsoft Foundry et Claude Platform on AWS, et anthropic.claude-sonnet-5-5 sur Amazon Bedrock, au 21 octobre 2026. Parmi les ID plus anciens figurent claude-sonnet-5 et claude-sonnet-4-6.

Combien coûte l'API Claude Sonnet ?

Claude Sonnet 5.5 coûte 2 $ par million de tokens en entrée et 10 $ par million de tokens en sortie, avec la lecture de cache à 0,10 $ et la Batch API à moitié prix (1 $ / 5 $), selon la page de tarification d'Anthropic vérifiée le 21 octobre 2026.

L'API Claude Sonnet est-elle gratuite ?

Non. L'API d'Anthropic est facturée au token ; il n'existe pas d'offre API gratuite pour Sonnet. Les applications Claude grand public ont leurs propres formules gratuites et payantes, indépendantes de la facturation API. Pour des options gratuites chez d'autres fournisseurs, consultez notre guide des API LLM gratuites.

Quelle est la fenêtre de contexte de Claude Sonnet 5.5 ?

1M de tokens, avec jusqu'à 128K tokens de sortie par requête, ou 300K sur la Message Batches API avec l'en-tête bêta output-300k-2026-03-24.

Pourquoi ma requête Sonnet renvoie-t-elle une erreur 400 après la mise à jour ?

Sonnet 5.5 refuse les budgets de réflexion, temperature/top_p/top_k, le préremplissage de l'assistant, le choix d'outil forcé et thinking: {"type": "disabled"}. Supprimez-les et utilisez output_config.effort ou thinking: {"type": "between_tools"}.

Existe-t-il une API Claude Sonnet 5 ?

Oui. claude-sonnet-5 reste appelable comme ancien modèle à 2 $ / 10 $ par million de tokens, avec la lecture de cache à 0,20 $. Sonnet 5.5 a les mêmes prix par token et une lecture de cache deux fois moins chère : c'est le meilleur choix par défaut pour les nouveaux projets.