Référence API

Messages (format Anthropic)

POST/v1/messages

Le format d'échange natif d'Anthropic, servi avec la même clé bearer. Claude Code et les SDK anthropic officiels fonctionnent en changeant uniquement l'URL de base — pas d'adaptateur, pas de conversion de format.

#Paramètres de la requête

  • modelstringobligatoire

    Un ID de modèle Claude issu de la page des modèles, par ex. claude-opus-5-5.

  • max_tokensintegerobligatoire

    Obligatoire dans le format Anthropic — le plafond strict de sortie.

  • messagesarrayobligatoire

    Tours au format Anthropic : {role: user|assistant, content}.

  • systemstringfacultatif

    Prompt système — ici un champ de premier niveau, pas un rôle de message.

  • streambooleanfacultatif

    Diffuse des événements SSE natifs Anthropic (message_start, content_block_delta, …).

  • temperaturenumberfacultatif

    De 0 à 1 selon l'échelle d'Anthropic.

  • toolsarrayfacultatif

    Définitions d'outils Anthropic ; les blocs tool_use reviennent dans content.

En-tête anthropic-version

Envoyez anthropic-version: 2023-06-01, comme l'attend l'API officielle. Authorization: Bearer fonctionne ici ; x-api-key est aussi accepté pour les SDK Anthropic standard.

#Erreurs associées

  • 400 invalid_request_errorCorps mal formé ou paramètre non pris en charge par ce modèle.
  • 401Jeton bearer invalide ou manquant. Pas de error.code sur ce chemin — basez-vous sur le statut.
  • 402 insufficient_user_quotaLe solde du portefeuille ne couvre pas l'estimation préréservée.
  • 429Limitation par clé. Corps vide ; attendez Retry-After. Un 429 qui contient insufficient_user_quota correspond en revanche à un plafond de dépenses quotidien.
  • 503 model_not_foundModèle inconnu, ou aucun canal opérationnel ne le sert actuellement.

Table complète des codes d'erreur →

#Exemple de requête

curl https://www.aisplice.store/v1/messages \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "Say hello."}]
  }'

#Réponse

response.json
{
  "id": "msg_…",
  "type": "message",
  "role": "assistant",
  "model": "claude-opus-5-5",
  "content": [{"type": "text", "text": "Hello!"}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 10, "output_tokens": 5}
}

Toujours bloqué ?

Envoyez-nous l'ID de requête ou le message d'erreur, et nous examinerons le problème.