Ihr erster RouterLab-API-Aufruf in 5 Minuten mit Python oder curl

Eine KI-API auszuprobieren sollte einfach sein: Konto erstellen, Schlüssel anlegen, Anfrage senden und eine Antwort erhalten.

Dieser Leitfaden begleitet Sie bis zu Ihrem ersten RouterLab-API-Aufruf und zeigt Ihnen, wie Sie Ihren Verbrauch prüfen. Sobald Ihre E-Mail-Adresse bestätigt ist, sollten Sie etwa fünf Minuten einplanen. Python oder curl muss bereits installiert sein.

1. Erstellen Sie Ihr Testkonto

Öffnen Sie die RouterLab-Testseite, registrieren Sie sich und bestätigen Sie Ihre E-Mail-Adresse, um Ihren Zugang zu aktivieren.

Der Testzugang umfasst:

• 7 Tage Zugang, nach Bestätigung Ihrer E-Mail-Adresse;
• 1 000 000 Tokens pro Tag, gemeinsam für alle Testmodelle;
• keine erforderliche Kreditkarte.

Ein Token ist eine Texteinheit, mit der Modelle arbeiten. Sowohl Ihre Anfrage als auch die erzeugte Antwort verbrauchen Tokens. Über den gesamten Testzeitraum sind maximal 7 Millionen Tokens möglich. Dieses Kontingent lässt sich nicht an einem einzigen Tag verbrauchen.

Der Zugang gilt für die Modelle im Testkatalog. Prüfen Sie die Liste auf der Testseite, um die zum Zeitpunkt Ihres Tests verfügbaren Routen zu sehen.

2. Erstellen Sie Ihren API-Schlüssel

Öffnen Sie in Ihrem Dashboard die Verwaltung der API-Schlüssel und erstellen Sie einen Schlüssel. Speichern Sie ihn in einer Umgebungsvariable, damit er nicht direkt im Skript steht. Teilen Sie ihn nicht und übernehmen Sie ihn nicht in ein Git-Repository.

In einem Terminal unter macOS oder Linux:

export ROUTERLAB_API_KEY="ihr-api-schluessel"

Unter Windows mit PowerShell:

$env:ROUTERLAB_API_KEY = "ihr-api-schluessel"

Ersetzen Sie ihr-api-schluessel durch Ihren RouterLab-Schlüssel. Die Variable gilt für diese Terminalsitzung. Lassen Sie das Terminal für den nächsten Schritt geöffnet.

3. Senden Sie Ihre erste Anfrage

Für diesen Test verwenden wir glm-5.3-flash-trial, das Modell aus dem Beispiel auf der offiziellen Testseite.

Wählen Sie nur eine der beiden folgenden Optionen: Python oder curl.

Option A — Python

Die hier verwendete API ist mit dem OpenAI-Format kompatibel. Sie können deshalb das OpenAI-SDK verwenden und RouterLab als Basis-URL einstellen.

Installieren Sie das SDK:

python -m pip install openai

Erstellen Sie eine Datei namens erster_aufruf.py mit folgendem 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": "Hallo RouterLab!"}
    ],
)

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

Wechseln Sie in dem Terminal, in dem Sie Ihren Schlüssel gesetzt haben, in das Verzeichnis der Datei und führen Sie sie aus:

python erster_aufruf.py

Je nach Installation heisst der Befehl unter macOS/Linux python3 oder unter Windows py. Verwenden Sie dann diesen Befehl sowohl für die SDK-Installation als auch zum Ausführen der Datei.

Wenn die Antwort des Modells erscheint, war Ihr erster Aufruf erfolgreich. Der Wortlaut kann bei jedem Aufruf anders ausfallen.

Option B — curl

So senden Sie dieselbe Anfrage aus einem Terminal unter macOS oder Linux, ohne das Python-SDK zu installieren:

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

Die Antwort hat das JSON-Format. Den erzeugten Text finden Sie unter choices[0].message.content.

4. Prüfen Sie Ihren Verbrauch

Öffnen Sie im Dashboard den Nutzungsverlauf, um Ihre Anfrage und die verbrauchten Tokens zu sehen. Falls die Anfrage noch nicht angezeigt wird, warten Sie einen Moment und aktualisieren Sie die Seite.

Machen Sie dies bereits bei Ihren ersten Tests zur Gewohnheit. So können Sie den Tokenverbrauch verschiedener Prompts vergleichen und Ihren Bedarf einschätzen, bevor Sie ein Angebot wählen.

Prüfen Sie vor einem Modellwechsel das Routen-Badge

Der Modellname allein bestimmt nicht das Format der Anfrage. Prüfen Sie das Routen-Badge im Katalog:

• OpenAI-compatible API: das Format dieses Leitfadens, mit POST /v1/chat/completions;
• Claude Messages API: das Messages-Format, mit POST /v1/messages.

Nur den Modellnamen im Skript zu ändern reicht nicht aus, wenn das neue Modell ein anderes Protokoll verwendet. Die RouterLab-API-Dokumentation erklärt beide Formate.

Wenn Ihr erster Aufruf fehlschlägt

Prüfen Sie zunächst diese drei Punkte:

• API-Schlüssel: Ist ROUTERLAB_API_KEY in dem Terminal gesetzt, das den Befehl ausführt?
• Modell: Haben Sie die genaue Kennung einschliesslich des Suffixes -trial kopiert, und steht das Modell im Testkatalog?
• Protokoll: Passt das Format Ihrer Anfrage zum Routen-Badge des Modells?

Prüfen Sie ausserdem, ob Ihre E-Mail-Adresse bestätigt ist, Ihr Testzugang noch läuft und Ihr Tageskontingent nicht aufgebraucht ist. Falls Sie für Ihre Evaluation ein grösseres Kontingent benötigen, eröffnen Sie über Ihr Konto ein Support-Ticket und beschreiben Sie Ihren Bedarf.

Wie geht es nach dem Test weiter?

Sobald Ihr erster Aufruf funktioniert, testen Sie einen Prompt aus Ihrer Anwendung: eine Nutzerfrage, eine Zusammenfassung oder eine Aufgabe zur Texterstellung.

Vergleichen Sie anschliessend die RouterLab-Angebote. Abonnements enthalten ein monatliches Guthaben. Prepaid-Guthaben ist auch ohne Abonnement erhältlich. Welche Modelle und Routen verfügbar sind, hängt vom gewählten Angebot ab.

Erstellen Sie Ihr Testkonto und senden Sie Ihre erste Anfrage.