GetRouterDocs
  • Français

    • Claude Messages

    Utilisez l’endpoint Messages compatible Claude pour les clients qui envoient des charges utiles de messages au format Anthropic.

    POST https://getrouter.ai/v1/messages

    Requête de base

    curl https://getrouter.ai/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "max_tokens": 512,
    "system": "Answer clearly and concisely.",
    "messages": [
      {"role": "user", "content": "Explain the purpose of a Base URL."}
    ]
  }'

    La réponse suit une structure de message compatible Claude, avec des blocs de contenu et, lorsqu’elles sont disponibles, des informations d’utilisation.

    Champs obligatoires

    ChampDescription
    modelID de modèle compatible Claude
    messagesMessages de la conversation
    max_tokensNombre maximal de tokens en sortie

    Champs facultatifs

    Le schéma de l’API comprend notamment les champs suivants :

    • system
    • temperature, top_p et top_k
    • stream
    • stop_sequences
    • tools et tool_choice
    • thinking
    • context_management
    • output_config et output_format
    • metadata
    • speed et service_tier

    La prise en charge dépend du modèle. N’envoyez pas une option au seul motif qu’elle figure dans le schéma ; vérifiez que le modèle sélectionné la prend en charge.

    Streaming

    Définissez stream sur true pour utiliser le streaming compatible Claude lorsqu’il est pris en charge :

    {
  "model": "MODEL_ID",
  "max_tokens": 512,
  "stream": true,
  "messages": [
    {"role": "user", "content": "Write a short release note."}
  ]
}

    Utilisez un analyseur d’événements Claude plutôt qu’un analyseur Chat Completions ou Responses.

    Prise en charge des outils et du raisonnement

    Les définitions d’outils compatibles Claude, les blocs de résultats d’outils et la configuration du raisonnement nécessitent un modèle doté des capacités correspondantes. Testez le flux de travail complet avant de l’activer dans des agents sans supervision.

    Warning

    Un ID de modèle Claude utilisé via un endpoint compatible OpenAI et ce même modèle utilisé via /v1/messages peuvent nécessiter un traitement différent des requêtes et des réponses. Configurez le protocole attendu par votre client.

    Intégrations d’outils

    Les outils tels que les clients de développement compatibles Claude peuvent nécessiter des variables d’environnement ou des paramètres du fournisseur supplémentaires. Suivez le guide dédié dans Intégrations plutôt que de remplacer uniquement le nom d’hôte.

    Étapes suivantes