Différences de paramètres et de protocoles de Claude

Découvrez les différences de paramètres et l’utilisation de Claude avec les protocoles compatibles.

Claude utilise nativement Messages. Pour Chat Completions, voir les limites de compatibilité officielles Anthropic ci-dessous ; la conversion de plateforme dépend du point d’entrée choisi.

Modèles concernés

Modèle	Défauts et activation du raisonnement
claude-haiku-5-5	Actif par défaut, effort `medium` ; `disabled` désactive uniquement aux niveaux `low/medium/high`
claude-sonnet-5-5	Actif par défaut, effort `high` ; `disabled` refusé. Aux niveaux `low/medium/high`, `between_tools` désactive la pensée avant réponse
claude-opus-5-5	Actif par défaut, effort `medium` ; non désactivable
claude-fable-5-1	Actif par défaut, effort `high` ; non désactivable
claude-opus-5	Actif par défaut, effort `high` ; `disabled` désactive uniquement aux niveaux `low/medium/high`
claude-sonnet-5	Actif par défaut, effort `high` ; désactivable avec `disabled`
claude-fable-5	Actif par défaut, effort `high` ; non désactivable
claude-opus-4-8	Inactif par défaut, effort `high` ; activer avec `adaptive`

Différences Messages

Champ	Différence
`thinking.type`	Les huit acceptent `adaptive`, pas l’ancien `enabled` ni `budget_tokens`. Désactivation selon le tableau ; `disabled` ne convient pas à tous
`between_tools`	Sonnet 5.5 seulement ; désactive la pensée avant réponse, mais progression entre outils dans `thinking`. Objet limité à `type`, sans `display` ni `budget_tokens`
`output_config.effort`	Les huit acceptent `low/medium/high/xhigh/max`, défauts ci-dessus ; `adaptive` est un type de pensée, pas un niveau. `max_tokens` limite pensée et réponse
`thinking.display`	Les huit utilisent `omitted` par défaut en raisonnement : texte vide et `signature`. Résumé lisible avec `summarized` ; texte vide ne signifie pas absence de pensée
`tool_choice`	Opus 5.5, Sonnet 5.5, Fable 5.1 refusent `any` et `tool` imposé ; utiliser `auto/none`. Les cinq autres permettent le forçage, qui saute la pensée de cet appel. Fable 5 n’a pas la restriction de Fable 5.1
Historique de pensée et signatures	Après appel d’outil, renvoyer tous les blocs `thinking/redacted_thinking` et outils précédents, même vides. Ne pas modifier, réordonner ou recréer les signatures. Haiku 5.5, Sonnet 5.5, Opus 5.5, Fable 5.1 vérifient aussi système, outils et historique d’origine ; ne pas réutiliser directement la pensée après modification
Préremplissage assistant	Les huit refusent un dernier message assistant inachevé avec `400` ; contraindre la sortie par instructions ou `output_config.format`
`temperature/top_p/top_k`	Omettre dans les exemples. `2023-06-01` conserve les restrictions des nouveaux modèles ; sous `2026-10-21`, tout modèle renvoie `400` si un de ces champs est présent. Changer de version ne restaure pas l’échantillonnage libre
Version des outils Computer	Claude API : Haiku 5.5, Sonnet 5.5, Opus 5.5 utilisent `computer_toolset_20260801`, pas les anciens types Computer. Autres clouds : voir les règles officielles

Différences de compatibilité Chat officielle

Ces règles concernent la couche OpenAI SDK d’Anthropic, distincte des capacités Messages natives ; tous les canaux de plateforme n’utilisent pas forcément la même conversion.

Champ	Différence
`n`	Accepte seulement `1`
`reasoning_effort`	Ignoré ; régler l’effort ou lire la pensée avec `output_config.effort` de Messages
`response_format`, `tools[].function.strict`	Ignorés ; n’activent ni sortie structurée native ni validation stricte d’outils
`presence_penalty/frequency_penalty/logit_bias/seed`	Ignorés ; aucun contrôle d’échantillonnage associé
`logprobs/top_logprobs`	Ignorés ; probabilités de tokens non renvoyées
`system/developer`	Fusionnés au début du prompt système, séparés par des sauts de ligne ; position intermédiaire non conservée
`tool_choice`	`required` et la fonction imposée respectent les limites des trois modèles ci-dessus
Cache et autres réglages	Pas de configuration de cache native ; `store/service_tier/metadata/prediction/user/audio/modalities` et autres champs ignorés, sans activer ces capacités

Différences de cache

Champ	Différence
`cache_control`	Utiliser `type: ephemeral` de Messages ; sélection automatique à la racine ou marqueurs explicites dans les blocs, au plus quatre points
`ttl`	Défaut `5m`, option `1h` ; différent de `prompt_cache_options` dans Chat
Préfixe minimal de cache	Haiku 5.5, Sonnet 5.5, Opus 5.5, Fable 5.1, Opus 5, Fable 5 : `512` tokens d’entrée ; Sonnet 5, Opus 4.8 : `1024`. Préfixe identique requis ; rien n’est écrit sous le seuil
Blocs de pensée	Pas de marqueur directement sur `thinking` ; la pensée rejouée peut être mise en cache dans le contenu assistant précédent
Utilisation du cache	Inspecter `usage.cache_creation_input_tokens`, `usage.cache_read_input_tokens` pour écriture et lecture ; configuration seule ne prouve pas un hit

Différences d’entrée multimédia

Entrée	Bloc du protocole	Différence
Image	Messages `image`	URL ou Base64 dans `source`, pas le bloc Chat `image_url`
Document	Messages `document`	Structure native de document dans user, pas dans assistant
Image	Chat `image_url`	La compatibilité officielle lit `image_url.url`, ignore `detail`
Fichier	Chat `file`	La compatibilité officielle ignore cette entrée ; pas les capacités documentaires natives
Audio	Chat `input_audio`	La compatibilité officielle ignore cette entrée ; pas de capacité audio native obtenue

Exemples d’appel

Remplacez MODEL_ID par l’ID complet. Messages active explicitement pensée adaptative et résumé ; Chat illustre le texte simple.

curl 'https://api.agtcloud.ai/v1/messages' \
  -H 'x-api-key: your-api-key' \
  -H 'anthropic-version: 2023-06-01' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "Expliquez en trois points comment diagnostiquer un délai d’attente API"}],
    "max_tokens": 4096,
    "thinking": {"type": "adaptive", "display": "summarized"},
    "output_config": {"effort": "medium"}
  }'