Source: https://aiprimetech.io/fr/docs/api-reference/messages/

[Accueil](/fr/) / [Documentation](/fr/docs/) / API Messages 

# API Messages 

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

 Copier la page [ Afficher au format Markdown](/fr/docs/api-reference/messages.md) [ Demander à ChatGPT](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/api-reference/messages.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Demander dans Claude](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/api-reference/messages.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

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](/fr/docs/api-reference/tool-use/)

 | metadata | objet | non | Transmis tel quel ; user_id est utile pour votre propre attribution 

## Exemple 

```
Copycurl 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 

```
Copy{
  "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 

```
Copy{
  "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](/fr/docs/guides/prompt-caching/) — 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](/fr/docs/api-reference/vision/). 

[Diffusion en continuSortie token par token](/fr/docs/api-reference/streaming/)[Utilisation des outilsAppel de fonctions](/fr/docs/api-reference/tool-use/)[ErreursModes de défaillance](/fr/docs/api-reference/errors/) 

[PrécédentPrésentation de l’API](/fr/docs/api-reference/overview/)[SuivantAPI Chat Completions](/fr/docs/api-reference/chat-completions/)