Anthropic Messages

Envoyez des messages et des Content Blocks avec la structure compatible Anthropic Messages.

L’API Messages crée des réponses à partir de messages user et assistant et de Content Blocks. Elle prend en charge le texte, les images, les appels d’outils, le streaming et la réflexion étendue. Les blocs de contenu, outils et paramètres avancés disponibles varient selon le modèle ; fiez-vous aux modèles visibles pour votre clé API et aux capacités réelles de l’interface.

POST/v1/messages

Génère la prochaine réponse assistant à partir des messages user et assistant. Le contenu peut être une chaîne ou des Content Blocks de texte, d’images, d’outils et de documents.

L’API prend en charge les réponses JSON ordinaires et les événements SSE en streaming ; les images, appels d’outils et capacités de réflexion étendue dépendent du modèle choisi.

Authentification

anthropicApiKey

x-api-key<token>

Transmettez la clé API dans le Header x-api-key.

Emplacement: header

Paramètres Header

anthropic-version*string

Version de l’API à utiliser.

Valeur par défaut"2023-06-01"

anthropic-beta?string

Version bêta à utiliser. Séparez plusieurs valeurs par des virgules ou envoyez ce Header plusieurs fois.

Corps de requête

Messages représente le texte, les images, les outils et la réflexion étendue avec des Content Blocks. Choisissez une vue selon votre tâche.

application/json

Conversation textuelle

Organisez une conversation à un ou plusieurs tours avec user et assistant ; system est un champ de premier niveau.

model: Identifiant d’un modèle visible pour votre clé API et compatible avec Messages.
max_tokens: Nombre maximal de tokens générés pour cette réponse.
messages[]: Messages user et assistant dans leur ordre d’envoi.

application/json

{
  "model": "MODEL_ID",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Bonjour ! Présentez-vous."
    }
  ]
}

Conversation textuelle simple. messages peut utiliser des chaînes ou des blocs text.

model*string

Identifiant du modèle à utiliser. Choisissez un modèle visible pour votre clé API et compatible avec Messages.

Longueur1 <= length <= 256

max_tokens*integer

Nombre maximal de tokens générés. Les limites varient selon le modèle ; 0 permet de remplir uniquement le cache de prompt sans générer de réponse.

Plage0 <= value

messages*array<>

Messages textuels dans leur ordre d’envoi. content peut être une chaîne ou un tableau de blocs text.

Éléments1 <= items

metadata?

Métadonnées associées à la requête.

cache_control?|null

Contrôle du cache au niveau supérieur, appliqué automatiquement au dernier bloc de contenu pouvant être mis en cache. Sa disponibilité dépend du modèle et du canal.

container?||null

Réutilise un conteneur entre requêtes ou indique les Skills à y charger. La disponibilité dépend du modèle, du canal et du compte.

inference_geo?string|null

Région géographique d’exécution de l’inférence ; si omise, la région par défaut du compte est utilisée. La disponibilité dépend du compte et du canal.

output_config?

Configuration de sortie du modèle. La disponibilité des champs dépend du modèle et du canal choisis.

service_tier?string

Niveau de service demandé. auto peut utiliser la capacité prioritaire lorsqu’elle est disponible ; standard_only utilise uniquement la capacité standard. La prise en charge dépend du compte et du canal.

Valeurs autorisées

"auto"
"standard_only"

stop_sequences?array<string>

Séquences textuelles personnalisées arrêtant la génération.

stream?boolean

Indique si la réponse est renvoyée progressivement via des événements envoyés par le serveur.

Valeur par défautfalse

system?|array<>

Prompt système au niveau supérieur. La liste Messages n’utilise pas le rôle system.

temperature?number

Obsolète

Obsolète. Les modèles publiés après Claude Opus 4.6 ne prennent pas en charge une temperature personnalisée ; 1.0 peut être accepté pour les anciennes requêtes, tandis que d’autres valeurs peuvent entraîner une erreur 400. Omettez ce champ pour les nouveaux modèles.

Plage0 <= value <= 1

thinking?||

Configuration de réflexion étendue. Privilégiez adaptive pour les nouveaux modèles ; les anciens peuvent continuer à utiliser enabled et budget_tokens.

tool_choice?||

tools?array<|||||||>

Outils personnalisés ou intégrés utilisables par le modèle.

top_k?integer

Obsolète

Obsolète. Les modèles publiés après Claude Opus 4.6 peuvent rejeter toute valeur top_k et renvoyer 400. Omettez ce champ pour les nouveaux modèles.

Plage1 <= value

top_p?number

Obsolète

Obsolète. Les modèles publiés après Claude Opus 4.6 ne conservent qu’une compatibilité limitée pour les réglages proches de la valeur par défaut ; d’autres valeurs peuvent entraîner une erreur 400. Omettez ce champ pour les nouveaux modèles.

Plage0 < value < 1

Les images, outils et capacités de réflexion étendue varient selon le modèle et le canal fournisseur. Commencez par une requête textuelle minimale, puis activez les champs avancés un par un.

Corps de réponse

`application/json`

curl -X POST "https://example.com/v1/messages" \  -H "anthropic-version: 2023-06-01" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "max_tokens": 1024,    "messages": [      {        "role": "user",        "content": "Bonjour ! Présentez-vous."      }    ]  }'

{
  "content": [
    {
      "type": "text",
      "text": "Bonjour ! Je suis un assistant IA."
    }
  ],
  "id": "msg_example",
  "model": "MODEL_ID",
  "role": "assistant",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "type": "message",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 16,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

Documentation officielle Anthropic MessagesConsultez la définition du protocole du fournisseur et les dernières modifications des champs.

Authentification

Paramètres Header

Corps de requête

Corps de réponse

200application/json

400application/json

401application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`