Claude Sonnet 5.5

Utilisez claude-sonnet-5-5 avec le format Anthropic Messages. Ce document distingue la spécification officielle des requêtes du comportement observé lors des tests de compatibilité. Certaines options avancées ne fonctionnent pas encore comme prévu par la spécification. Consultez les limites avant de vous y fier.

Consultez la page du modèle pour connaître les tarifs actuels des entrées, des sorties et du cache.

Démarrage rapide

curl https://api.seedrouter.ai/v1/messages \
  -H "x-api-key: $SEEDROUTER_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Explain how a rainbow forms in three sentences."}]
  }'

POST /v1/messages accepte l’authentification par x-api-key ou Bearer, ainsi que anthropic-version: 2023-06-01. Envoyez un en-tête anthropic-beta pour les fonctionnalités dont la documentation officielle l’exige. Conservez les identifiants d’accès dans le code côté serveur.

Le modèle accepte également les requêtes de base OpenAI Chat Completions (POST /v1/chat/completions) et Responses (POST /v1/responses). Utilisez Messages pour les paramètres natifs décrits ci-dessous. La conversion du format OpenAI ne donne pas accès à toutes les fonctionnalités d’Anthropic.

Spécification officielle des paramètres

Sonnet 5.5 dispose d’une fenêtre de contexte de 1M tokens et d’une limite de sortie synchrone de 128000 tokens. Les limites de sortie propres à Batch ne s’appliquent pas à cet endpoint. Sauf indication contraire dans le tableau, l’application ne définit pas de valeur par défaut pour les propriétés facultatives.

between_tools accepte uniquement sa propriété type et les niveaux d’effort low, medium ou high. N’envoyez pas display, budget_tokens ou block_binding avec ce mode. Exemple :

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "thinking": {"type": "between_tools"},
  "output_config": {"effort": "medium"},
  "messages": [{"role": "user", "content": "Explain this concept briefly."}]
}

Le préremplissage de l’assistant n’est pas pris en charge. Pour poursuivre un pause_turn, renvoyez à l’identique le contenu assistant de l’outil serveur reçu dans la réponse. La compaction résume l’historique existant et ne constitue pas un préremplissage de l’assistant. Conservez exactement les blocs de réflexion et leurs signatures. Ne les déplacez pas entre modèles et ne modifiez pas l’historique antérieur sans respecter les règles officielles de liaison.

Sur l’API Claude native, l’utilisation de l’ordinateur nécessite computer_toolset_20260801 ; computer_20251124 est rejeté. Les configurations Advisor utilisant claude-opus-4-8, claude-opus-4-7 ou claude-sonnet-5 sont également rejetées pour ce modèle exécutant.

Champs de requête de repli

La fonctionnalité beta officielle fallbacks relance les requêtes faisant l’objet d’un refus du classificateur admissible à une nouvelle tentative. Elle ne relance pas les requêtes en cas de limitation de débit, de surcharge ou d’erreur serveur, et le refus peut persister. Envoyez server-side-fallback-2026-07-01 pour utiliser "default" ou une liste explicite ; server-side-fallback-2026-06-01 ne prend en charge que la liste. Les autres versions datées sont rejetées.

Une liste explicite contient au maximum trois entrées avec des modèles distincts, tous différents du modèle demandé. Les cibles autorisées proviennent de allowed_fallback_models dans la beta Models API. Seuls model, max_tokens, thinking, output_config et speed sont permis par entrée ; les valeurs de remplacement doivent être valides pour le modèle cible. Lors du repli concerné, la beta de juillet convertit between_tools de Sonnet 5.5 en disabled pour Sonnet 5, sans display. Avec la beta de juin, fournissez vous-même le remplacement du réglage de réflexion de Sonnet 5.

fallback_credit_token sert à une nouvelle tentative distincte après un refus. Une chaîne sélectionne l’utilisation stricte du crédit ; un objet ajoute mode. En mode strict, l’échec de l’utilisation du crédit entraîne le rejet de la nouvelle tentative. En mode best_effort, une défaillance au niveau du token peut laisser la requête se poursuivre au tarif normal et est consignée dans usage.fallback_credit. Les tokens mal formés et l’utilisation du crédit avec fallbacks échouent toujours. L’utilisation du crédit exige aussi de respecter les conditions relatives à la requête admissible, au compte, à l’espace de travail, à la plateforme et à la fenêtre de cinq minutes décrites dans le guide officiel du crédit.

Une requête au contenu inoffensif avec fallbacks: "default", l’en-tête beta de juillet et speed: "standard" a renvoyé le texte attendu. Cela établit uniquement que la requête a été acceptée : l’exécution du repli et l’utilisation du crédit n’ont pas été vérifiées de bout en bout ici.

Entrées média et outils

Les images utilisent des blocs image et les PDF des blocs document dans un message utilisateur. Les types de source officiels comprennent les URL publiques et le base64 avec le type MIME correspondant. Les contrôles de compatibilité ont utilisé un PNG en base64 et un PDF d’une page en base64, puis vérifié le contenu des réponses. Ils n’ont pas testé toutes les URL ni toutes les limites de taille des fichiers, de résolution des images ou de nombre de pages PDF.

Les outils côté client utilisent l’échange standard tool_use → tool_result. Conservez les identifiants d’utilisation des outils et renvoyez le résultat dans un message utilisateur. La réussite d’un exemple d’outil en mode strict vérifie les arguments de cet exemple, pas tous les mots-clés JSON Schema pris en charge.

Réponses

Une réponse sans streaming contient id, type: "message", role: "assistant", model, content, stop_reason, stop_sequence et usage, ainsi que des champs officiels facultatifs tels que container, diagnostics, context_management, stop_details et les champs de réponse beta. Le contenu peut inclure du texte, de la réflexion, des appels d’outils, des résultats d’outils ou d’autres types de blocs officiels. Ne supposez pas que le premier bloc contient du texte.

En streaming, gérez message_start, content_block_start, content_block_delta, content_block_stop, message_delta et message_stop. Des erreurs peuvent également survenir au sein du flux. L’utilisation peut comprendre les tokens ordinaires d’entrée/sortie, le détail des tokens de réflexion, les lectures du cache et les décomptes distincts de création de cache pour les durées de 5 minutes / 1 heure.

Un refus officiel du classificateur est une réponse normale avec stop_reason: "refusal" et stop_details, plutôt qu’une erreur HTTP. Dans une réponse de repli, model identifie le modèle qui a répondu, les blocs de contenu fallback marquent les transitions et usage.iterations décrit les tentatives. Examinez ces champs au lieu de supposer que le modèle demandé a fourni la réponse. Ces comportements de réponse restent non vérifiés ici.

Les erreurs Messages utilisent {"type":"error","error":{"type":"...","message":"..."}}. Les requêtes échouées ne sont pas facturées.

Vérification de compatibilité : 2026-10-01

L’exécution d’outils beta, les connexions MCP réelles, les références Files API, la résidence géographique des données, le renvoi des signatures de réflexion, les plafonds complets de contexte/sortie, les cas limites des médias et le comportement de refus/repli n’ont pas été validés de bout en bout. Un code HTTP 200 et le nom de modèle renvoyé ne permettent pas d’authentifier le modèle réellement exécuté ni de prouver que toutes les options fournies ont pris effet.

Références

• Présentation officielle de Sonnet 5.5
• Changements et restrictions de Sonnet 5.5
• Référence des paramètres Messages
• Effort par message
• Compaction à la demande
• Refus et repli
• Crédit de repli
• Schéma OpenAPI
• Markdown à copier