API Messages

POST /v1/messages — l’endpoint au format Anthropic : paramètres, structure de la réponse et exemples.

Afficher au format Markdown Demander à ChatGPT Demander dans Claude

Le point de terminaison utilisé par tous les clients compatibles avec Anthropic, y compris Claude Code et les SDK officiels.

EndpointPOST https://aiprimetech.io/v1/messages

Authentificationx-api-key: sk-...

En-tête de versionanthropic-version: 2023-06-01

Type de contenuapplication/json

Corps de la requête

Champ	Type	Obligatoire	Description
`model`	chaîne	oui	Identifiant du modèle, exactement tel qu’il figure dans `/v1/models`
`messages`	tableau	oui	Alternance des tours utilisateur / assistant, du plus ancien au plus récent
`max_tokens`	entier	oui	Nombre maximal de tokens de sortie. La génération s’arrête à cette limite.
`system`	chaîne ou tableau	non	Prompt système de premier niveau. Il ne s’agit pas d’un rôle de message.
`temperature`	nombre	non	0–1. Omettez ce paramètre pour utiliser la valeur par défaut du modèle.
`top_p`	nombre	non	Échantillonnage par noyau. Utilisez ce paramètre ou la température, mais pas les deux.
`stop_sequences`	tableau	non	Chaînes qui arrêtent la génération lorsqu’elles sont produites
`stream`	booléen	non	true pour les événements envoyés par le serveur
`tools`	tableau	non	Définitions des outils — voir Utilisation des outils
`metadata`	objet	non	Transmis tel quel ; `user_id` est utile pour votre propre attribution

Exemple

curl https://aiprimetech.io/v1/messages \
  -H "x-api-key: $CLAUDEAPIKEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Réponse

{
  "id": "msg_01ABC...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [{"type": "text", "text": "..."}],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {"input_tokens": 9, "output_tokens": 12}
}

Champ	Description
`content`	Tableau de blocs. Les blocs de texte contiennent `type: text` et un `text` champ ; les appels d’outils contiennent `type: tool_use`.
`stop_reason`	`end_turn`, `max_tokens`, `stop_sequence` ou `tool_use`
`usage.input_tokens`	Entrée facturée, y compris l’intégralité de l’historique renvoyé
`usage.output_tokens`	Sortie facturée — généralement 4–5× le tarif d’entrée

Prompts système

{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "system": "You are a terse assistant. Answer in at most two sentences.",
  "messages": [{"role": "user", "content": "Explain HTTP caching."}]
}

Un bloc stable de type system est la cible idéale pour la mise en cache des prompts — il est identique à chaque appel et peut donc être lu depuis le cache pour une fraction du prix d’entrée.

Entrée multimodale

Les blocs d’images utilisent la structure standard d’Anthropic — voir Vision.

Diffusion en continuSortie token par token Utilisation des outilsAppel de fonctions ErreursModes de défaillance