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 · OpenAI-compatible
Vous conservez la forme de requête OpenAI. Seuls la base URL, la clé et l’identifiant du modèle changent.
La compatibilité OpenAI permet de réutiliser les SDK et outils qui acceptent une base URL personnalisée.
Générez une clé dans le tableau de bord RouterLab et gardez-la côté serveur.
Appelez GET /v1/models pour récupérer les identifiants réellement disponibles.
Configurez votre client sur https://api.routerlab.ch/v1.
Utilisez l’identifiant exact du modèle et le format chat/completions habituel.
Le même contrat fonctionne en HTTP direct ou avec le SDK OpenAI.
cURL shell
curl https://api.routerlab.ch/v1/chat/completions \
-H "Authorization: Bearer $ROUTERLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"glm-5.3-flash-trial","max_tokens":128,"messages":[{"role":"user","content":"Hello RouterLab"}]}'Python · OpenAI SDK python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ROUTERLAB_API_KEY"],
base_url="https://api.routerlab.ch/v1",
)
response = client.chat.completions.create(
model="glm-5.3-flash-trial",
max_tokens=128,
messages=[{"role": "user", "content": "Hello RouterLab"}],
)
print(response.choices[0].message.content)TypeScript · OpenAI SDK typescript
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.ROUTERLAB_API_KEY,
baseURL: "https://api.routerlab.ch/v1",
});
const response = await client.chat.completions.create({
model: "glm-5.3-flash-trial",
messages: [{ role: "user", content: "Hello" }],
});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.
Utilisez /v1 comme base URL du SDK et un identifiant exact de /v1/models. Le guide couvre chat/completions ; n’en déduisez pas la compatibilité avec tous les autres endpoints ou paramètres du SDK.
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 python
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["ROUTERLAB_API_KEY"], base_url="https://api.routerlab.ch/v1")
stream = client.chat.completions.create(
model="glm-5.3-flash-trial",
max_tokens=128,
messages=[{"role": "user", "content": "Hello RouterLab"}],
stream=True,
)
for part in stream:
if part.choices and part.choices[0].delta.content:
print(part.choices[0].delta.content, end="", flush=True)RouterLab normalise l’accès, mais les capacités restent celles du modèle choisi.
Messages, rôles, streaming et outils suivent le contrat OpenAI quand la route les prend en charge.
Le champ model doit contenir un identifiant retourné par GET /v1/models.
Vision, outils, contexte et sortie structurée sont indiqués dans le catalogue.
Vous pouvez changer de famille de modèles sans changer de SDK lorsque la même route est disponible.
Ce sont des familles de modèles. Vous gardez cette intégration et remplacez seulement la valeur du champ model. Vérifiez toujours les badges de route du catalogue.
Commencez par vérifier la clé, l’identifiant du modèle et le solde.
| HTTP | Cause probable | Action |
|---|---|---|
| 400 | Corps invalide ou paramètre non pris en charge. | Comparez la requête au contrat chat/completions et aux capacités du modèle. |
| 401 | Clé absente, invalide ou révoquée. | Vérifiez l’en-tête Authorization et régénérez la clé si nécessaire. |
| 404 | Identifiant de modèle inconnu. | Relisez la liste retournée par GET /v1/models. |
| 429 | Limite de débit ou crédit disponible atteint. | Réduisez la cadence puis contrôlez vos limites dans le tableau de bord. |
| 503 | Route temporairement indisponible. | Réessayez avec backoff ou sélectionnez un autre modèle compatible. |
Utilisez le second protocole documenté par RouterLab au lieu d’adapter artificiellement les requêtes.
Voir le guide Claude MessagesMesure 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.