Votre premier appel API RouterLab en 5 minutes avec Python ou curl

Tester une API d’intelligence artificielle devrait être simple : créer un compte, obtenir une clé, envoyer une requête et recevoir une réponse.

Ce guide vous accompagne jusqu’à votre premier appel RouterLab, puis vous montre comment vérifier votre consommation. Une fois votre adresse email confirmée, prévoyez environ cinq minutes avec Python ou curl déjà installé.

1. Créez votre compte d’essai

Rendez-vous sur la page d’essai RouterLab, inscrivez-vous et confirmez votre adresse email pour activer votre accès.

L’essai comprend :

• 7 jours d’accès, après vérification de votre email ;
• 1 000 000 de tokens par jour, partagés entre tous les modèles de l’essai ;
• aucune carte bancaire à fournir.

Un token est une unité de texte utilisée par les modèles. Votre requête et la réponse générée en consomment. Le quota représente un maximum de 7 millions de tokens sur la période ; il ne constitue pas une réserve utilisable en une seule journée.

L’accès concerne les modèles du catalogue d’essai. Consultez la liste sur la page d’essai pour connaître les routes disponibles au moment de votre test.

2. Créez votre clé API

Depuis votre tableau de bord, ouvrez la gestion des clés API et créez une clé. Conservez-la dans une variable d’environnement pour éviter de l’inscrire directement dans votre script. Ne la partagez pas et ne l’ajoutez pas à un dépôt Git.

Dans un terminal macOS ou Linux :

export ROUTERLAB_API_KEY="votre-cle-api"

Sous Windows avec PowerShell :

$env:ROUTERLAB_API_KEY = "votre-cle-api"

Remplacez votre-cle-api par votre clé RouterLab. Cette variable est définie pour la session du terminal : gardez-le ouvert pour la suite.

3. Envoyez votre première requête

Pour ce premier test, nous utilisons glm-5.3-flash-trial, le modèle de l’exemple publié sur la page d’essai officielle.

Choisissez une seule des deux options ci-dessous : Python ou curl.

Option A — Python

L’API utilisée ici est compatible avec le format OpenAI. Vous pouvez donc employer le SDK OpenAI en configurant l’adresse de RouterLab.

Installez le SDK :

python -m pip install openai

Créez un fichier nommé premier_appel.py et ajoutez ce code :

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": "Bonjour RouterLab !"}
    ],
)

print(response.choices[0].message.content)

Dans le terminal où vous avez défini votre clé, placez-vous dans le dossier du fichier, puis exécutez :

python premier_appel.py

Selon votre installation, la commande peut être python3 sur macOS/Linux ou py sous Windows. Utilisez alors cette commande pour l’installation du SDK et l’exécution du fichier.

Si une réponse du modèle s’affiche, votre premier appel a réussi. Son texte peut varier d’un appel à l’autre.

Option B — curl

Pour envoyer la même requête depuis un terminal macOS ou Linux, sans installer le SDK Python :

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": "Bonjour RouterLab !"}
    ]
  }'

La réponse arrive au format JSON. Le texte généré se trouve dans choices[0].message.content.

4. Vérifiez votre consommation

Retournez dans votre tableau de bord et ouvrez l’historique d’usage pour retrouver votre requête et consulter les tokens consommés. Si elle n’apparaît pas encore, patientez quelques instants et actualisez la page.

Prenez cette habitude dès vos premiers tests. Elle vous aidera à comparer la consommation de vos prompts et à évaluer vos besoins avant de choisir une offre.

Avant de changer de modèle, vérifiez son badge

Le nom du modèle ne suffit pas à déterminer le format de la requête. Consultez le badge de sa route dans le catalogue :

• OpenAI-compatible API : format utilisé dans ce guide, avec POST /v1/chat/completions ;
• Claude Messages API : format Messages, avec POST /v1/messages.

Changer uniquement le nom du modèle dans le script ne suffit pas si le nouveau modèle utilise un autre protocole. La documentation API RouterLab présente les deux formats.

Si votre premier appel échoue

Commencez par ces trois vérifications :

• Clé API : la variable ROUTERLAB_API_KEY est-elle définie dans le terminal qui exécute la commande ?
• Modèle : avez-vous copié son identifiant exact, notamment le suffixe -trial, et figure-t-il dans le catalogue d’essai ?
• Protocole : le format de votre requête correspond-il au badge du modèle ?

Vérifiez également que votre email est confirmé, que l’essai est encore actif et que le quota quotidien n’est pas épuisé. Si votre évaluation nécessite un quota supérieur, ouvrez un ticket depuis votre compte pour préciser votre besoin.

Et après l’essai ?

Une fois le premier appel réussi, testez un prompt représentatif de votre application : une question utilisateur, un résumé ou une tâche de génération de texte.

Vous pourrez ensuite consulter les offres RouterLab. Les abonnements proposent une allocation mensuelle de crédits ; des crédits prépayés sont également disponibles sans abonnement. Les modèles et routes accessibles dépendent de l’offre choisie.

Créez votre compte d’essai et envoyez votre première requête.