Protocole · Claude Messages

Claude Messages API avec RouterLab

Connectez votre application à POST /v1/messages avec une clé RouterLab. Claude Messages désigne le protocole ; choisissez séparément un modèle compatible dans le catalogue, puis vérifiez vos droits avec GET /v1/models. La présence d’une fiche publique ne garantit pas l’accès de votre compte.

Contrat de requêteprêt
Base URL
https://api.routerlab.ch
Endpoint
POST /v1/messages
Authentification
x-api-key: $ROUTERLAB_API_KEY · anthropic-version: 2023-06-01
Identifiants
GET /v1/models

Démarrage en quatre étapes

Utilisez cette route uniquement pour les modèles dont le catalogue affiche le badge Claude Messages.

  1. 01

    Créez une clé

    Générez une clé RouterLab et conservez-la dans une variable d’environnement côté serveur.

  2. 02

    Vérifiez la route

    Dans le catalogue, choisissez un modèle explicitement compatible Claude Messages.

  3. 03

    Formez le message

    Envoyez model, max_tokens et messages au format Messages.

  4. 04

    Traitez la réponse

    Lisez les blocs content et les informations d’usage renvoyés par la route.

Exemples prêts à adapter

Ces exemples utilisent anthropic-version: 2023-06-01, le contrat actuellement publié par RouterLab. Installez le SDK Python Anthropic 1.x (anthropic>=1,<2) : la majeure 2 utilise par défaut la version d’API 2026-10-21, plus récente que ce contrat. Définissez ROUTERLAB_API_KEY dans l’environnement du serveur ; la base URL du SDK Messages ne contient pas /v1.

Python SDK 1.x shell

python -m pip install "anthropic>=1,<2"

Python · Anthropic SDK 1.x python

import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["ROUTERLAB_API_KEY"],
    base_url="https://api.routerlab.ch",
    max_retries=0,
)

message = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=128,
    messages=[{"role": "user", "content": "Hello RouterLab"}],
)

text = "".join(block.text for block in message.content if block.type == "text")
print(text)
print("input_tokens:", message.usage.input_tokens)
print("output_tokens:", message.usage.output_tokens)

cURL shell

curl https://api.routerlab.ch/v1/messages \
  -H "x-api-key: $ROUTERLAB_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5-5","max_tokens":128,"messages":[{"role":"user","content":"Hello RouterLab"}]}'

TypeScript · fetch typescript

const response = await fetch("https://api.routerlab.ch/v1/messages", {
  method: "POST",
  headers: {
    "x-api-key": process.env.ROUTERLAB_API_KEY!,
    "anthropic-version": "2023-06-01",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "claude-sonnet-5-5",
    max_tokens: 512,
    messages: [{ role: "user", content: "Hello" }],
  }),
});

if (!response.ok) throw new Error("HTTP " + response.status);
const data = await response.json();
const text = data.content.filter((block: { type: string }) => block.type === "text")
  .map((block: { text: string }) => block.text).join("");
console.log(text, data.usage);

Python · requests python

import os
import requests

response = requests.post(
    "https://api.routerlab.ch/v1/messages",
    headers={"x-api-key": os.environ["ROUTERLAB_API_KEY"], "anthropic-version": "2023-06-01"},
    json={
        "model": "claude-sonnet-5-5",
        "max_tokens": 512,
        "messages": [{"role": "user", "content": "Hello"}],
    },
)
response.raise_for_status()
print(response.json())

Passer du premier appel à votre application

Commencez par un appel court, vérifiez sa réponse et son usage, puis ajoutez uniquement les fonctions publiées pour le modèle choisi.

Choisir un modèle accessible

GET /v1/models, avec votre clé RouterLab, donne les identifiants accessibles à votre compte. Une fiche publique ne garantit pas l’accès avec votre plan. L’essai est limité aux modèles marqués Trial.

Respecter le protocole

POST /v1/messages utilise x-api-key, anthropic-version et max_tokens. Ne remplacez pas simplement le chemin d’une requête chat/completions : les blocs de réponse et les outils ont un format différent.

Outils et sorties structurées

Vérifiez les badges de la fiche avant d’ajouter tools ou un format de sortie. Votre application exécute elle-même les outils et valide les données reçues. Le support dépend du modèle et de la route.

Vérifier la fin du flux et le budget

Le streaming exige le badge Streaming. Une connexion interrompue ne prouve pas la réussite de l’appel. Sur 429, distinguez le débit du budget épuisé ; ne relancez pas automatiquement une génération dont vous avez déjà reçu une partie.

Streaming avec le modèle de l’exemple shell

curl -N https://api.routerlab.ch/v1/messages \
  -H "x-api-key: $ROUTERLAB_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5-5","max_tokens":128,"messages":[{"role":"user","content":"Hello RouterLab"}],"stream":true}'

Réponse illustrative

Exemple de structure, sans appel réel : texte et compteurs sont fictifs. La réponse peut contenir plusieurs blocs ; extrayez uniquement les blocs text et lisez usage.input_tokens et usage.output_tokens. Un bloc tool_use demande une exécution dans votre application et un retour tool_result ; il ne constitue pas du texte à afficher.

HTTP 200 · application/json json

{
  "id": "msg_example",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5-5",
  "content": [
    {
      "type": "text",
      "text": "Hello! How can I help?"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 8,
    "output_tokens": 12
  }
}

Ce que représente cette route

Claude Messages est un format d’échange. Le modèle reste un choix séparé, contrôlé par son identifiant et ses capacités.

Format Messages

La requête utilise messages, max_tokens et les blocs de contenu attendus par ce protocole.

Route déclarée

N’utilisez que les modèles affichant le badge Claude Messages dans le catalogue.

Capacités variables

Outils, vision, contexte et raisonnement dépendent du modèle choisi.

Autre protocole disponible

Si votre SDK attend chat/completions, utilisez le guide OpenAI-compatible.

Claude Code passe par ScioNos

Pour l’outil Claude Code, utilisez le wrapper ScioNos : il configure le terminal et l’authentification. Cette page reste la documentation de l’API HTTP directe.

Erreurs courantes

Vérifiez d’abord le format Messages et la compatibilité de route du modèle.

HTTPCause probableAction
400Champ requis absent ou contenu mal formé.Vérifiez notamment model, max_tokens et messages.
401Clé absente, invalide ou révoquée.Contrôlez x-api-key et anthropic-version, comme dans les exemples de cette page.
404Modèle inconnu ou non disponible.Choisissez un identifiant exposé par GET /v1/models.
429Limite de débit ou crédit atteint.Réduisez la cadence et contrôlez le compte RouterLab.
503Route temporairement indisponible.Réessayez avec backoff ou sélectionnez une autre route compatible.

Références officielles

La documentation Anthropic décrit le protocole et le SDK. Les fonctionnalités disponibles sur RouterLab restent celles publiées pour la route et le modèle ; les API beta, batch, fichiers et outils hébergés ne sont pas garantis par la compatibilité Messages.

Besoin de Claude Code ou Codex CLI ?

ScioNos est l’intégration dédiée aux agents de code en terminal. Elle évite de reproduire leur configuration à la main.

Configurer les agents avec ScioNos

Mesure d’audience

Acceptez-vous que Google Analytics et RouterLab mesurent les visites publiques et relient la source de campagne à votre inscription ? Ce choix est facultatif et modifiable à tout moment. En cas de refus, seuls des totaux anonymes de visites sont conservés.