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.
Protocole · Claude Messages
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.
Utilisez cette route uniquement pour les modèles dont le catalogue affiche le badge Claude Messages.
Générez une clé RouterLab et conservez-la dans une variable d’environnement côté serveur.
Dans le catalogue, choisissez un modèle explicitement compatible Claude Messages.
Envoyez model, max_tokens et messages au format Messages.
Lisez les blocs content et les informations d’usage renvoyés par la route.
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())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.
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.
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.
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.
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}'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
}
}Claude Messages est un format d’échange. Le modèle reste un choix séparé, contrôlé par son identifiant et ses capacités.
La requête utilise messages, max_tokens et les blocs de contenu attendus par ce protocole.
N’utilisez que les modèles affichant le badge Claude Messages dans le catalogue.
Outils, vision, contexte et raisonnement dépendent du modèle choisi.
Si votre SDK attend chat/completions, utilisez le guide OpenAI-compatible.
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.
Vérifiez d’abord le format Messages et la compatibilité de route du modèle.
| HTTP | Cause probable | Action |
|---|---|---|
| 400 | Champ requis absent ou contenu mal formé. | Vérifiez notamment model, max_tokens et messages. |
| 401 | Clé absente, invalide ou révoquée. | Contrôlez x-api-key et anthropic-version, comme dans les exemples de cette page. |
| 404 | Modèle inconnu ou non disponible. | Choisissez un identifiant exposé par GET /v1/models. |
| 429 | Limite de débit ou crédit atteint. | Réduisez la cadence et contrôlez le compte RouterLab. |
| 503 | Route temporairement indisponible. | Réessayez avec backoff ou sélectionnez une autre route compatible. |
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.
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 ScioNosMesure 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.