Créer un message Claude

Requête au format de l’API Anthropic Claude Messages. L’en-tête anthropic-version doit être présent.

POST /v1/messages

Racine du service: https://getrouter.ai

Protocole: Anthropic Messages

Authentification: x-api-key: YOUR_API_KEY

Paramètres

ParamètreEmplacementTypeObligatoireDescription
anthropic-versionheaderstringOuiVersion de l’API Anthropic
x-api-keyheaderstringNonClé API Anthropic (facultative, un jeton Bearer peut également être utilisé)

Corps de la requête

Le corps de la requête est facultatif. Type de média: application/json

Champs de la requête

ChampTypeObligatoireDescription
modelstringOui
messagesarray<object>Oui
systemstring or array<object>Non
cache_controlobjectNon
inference_geostringNon
max_tokensintegerOuiPlage: 1–∞
temperaturenumberNonPlage: 0–1
top_pnumberNon
top_kintegerNon
streambooleanNon
stop_sequencesarray<string>Non
toolsarray<object>Non
tool_choiceobjectNon
thinkingobjectNon
context_managementobjectNon
output_configobjectNon
output_formatobjectNon
containerstring or objectNon
mcp_serversarray<object>Non
metadataobjectNon
speedstringNonValeurs autorisées: standard, fast
service_tierstringNonValeurs autorisées: auto, standard_only

Exemple de requête

curl --request POST \
  --url https://getrouter.ai/v1/messages \
  --header "x-api-key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "Bonjour, présentez-vous."
    }
  ],
  "max_tokens": 1,
  "stream": false,
  "temperature": 0
}'

Réponses

StatutDescription
200Réponse créée

Champs d’une réponse réussie

ChampTypeObligatoireDescription
idstringNon
typestringNon
rolestringNon
contentarray<object>Non
modelstringNon
stop_reasonstringNonValeurs autorisées: end_turn, max_tokens, stop_sequence, tool_use
usageobjectNon

Exemple de réponse

{
  "id": "string",
  "type": "string",
  "role": "user",
  "content": [
    {
      "type": "string",
      "text": "string"
    }
  ],
  "model": "MODEL_ID",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 1,
    "output_tokens": 1,
    "cache_creation_input_tokens": 1,
    "cache_read_input_tokens": 1
  }
}

Guide associé

Pour les flux de travail et exemples complets, consultez le guide de l’API Claude Messages.


Cette page est générée à partir de la spécification OpenAPI Relay publique. Consultez la spécification complète dans l’API Explorer.