POST /v1/messages

Chat completions au format natif Anthropic. Requête et réponse 100 % identiques ; tool_choice est la seule couche de normalisation.

Requête

http

POST https://api-ai.fr/v1/messages
x-api-key: mdf-...
anthropic-version: 2023-06-01
content-type: application/json

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "system": "You are a concise assistant.",
  "messages": [
    {"role": "user", "content": "Why is the sky blue?"}
  ]
}

Corps de la requête

Données de référence
Champ	Type	Obligatoire	Remarques
`model`	string	oui	L’un des identifiants de modèles pris en charge (liste Claude autorisée sur `/v1/messages`)
`messages`	array	oui	Paires `{role, content}`
`max_tokens`	int	oui	Plafond strict de la sortie
`system`	string	non	Prompt système
`temperature`	0.0–1.0	non
`top_p`	0.0–1.0	non
`top_k`	int	non
`stop_sequences`	array	non
`stream`	bool	non	Voir Streaming
`tools`	array	non	Voir Utilisation d’outils
`tool_choice`	object	non	Normalisé — voir la page des outils

Cache de prompts

Marquez jusqu’à quatre points de cache avec cache_control: {"type": "ephemeral"} sur des blocs texte ou système. Les tokens lus depuis le cache sont facturés à 10 % du tarif d’entrée normal (et l’amont renvoie cache_read_input_tokens dans usage).

json

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "system": [
    {
      "type": "text",
      "text": "Long stable system prompt that should be cached...",
      "cache_control": {"type": "ephemeral"}
    }
  ],
  "messages": [{"role": "user", "content": "Question 1"}]
}

Réponse

json

{
  "id": "msg_01XYZ...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5-5",
  "content": [
    {"type": "text", "text": "Rayleigh scattering — short wavelengths..."}
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 48,
    "output_tokens": 92,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

Compatibilité Anthropic

Le format des requêtes et des réponses est compatible octet pour octet avec l’API Messages d’Anthropic. Si votre code appelle api.anthropic.com aujourd’hui, le seul changement nécessaire est base_url.

Dernière mise à jour : 2 octobre 2026Une erreur ? support@minedom-france.fr