Erste Schritte

Quickstart

Führen Sie Ihre erste TokenLab API-Anfrage mit cURL, Python, JavaScript, Go oder PHP durch. Richten Sie Ihren API-Key ein, konfigurieren Sie den Endpunkt und verifizieren Sie eine Chat Completions-Antwort.

API-Key abrufen

Konto erstellen

Registrieren Sie sich unter tokenlab.sh mit Ihrer E-Mail-Adresse, Ihrem Google- oder GitHub-Konto.

API-Key erstellen und speichern

Öffnen Sie API Keys in Ihrem Workspace. Erstellen Sie einen Key und speichern Sie den vollständigen Wert sofort; er wird nur einmal angezeigt. Wenn Sie bereits einen vollständigen Key gespeichert haben, verwenden Sie diesen Wert. Das Präfix, das in der Liste angezeigt oder kopiert wird, kann keine Anfragen authentifizieren.

Workspace-Guthaben prüfen

Überprüfen Sie Ihr Guthaben unter Billing. Ein neues Konto erhält möglicherweise ein einmaliges Testguthaben; andernfalls beginnt es bei $0 und erfordert vor der ersten Anfrage eine Aufladung (mindestens $5). Die Anfrage wird zum aktuellen Preis des ausgewählten Modells abgerechnet.

Halten Sie den API-Key geheim. Speichern Sie ihn nicht in clientseitigem Code oder in einem öffentlichen Repository.

Key für dieses Terminal festlegen

Die folgenden Befehle halten den Key aus dem Befehl selbst heraus. Sie legen ihn nur für das aktuelle Terminal und dessen untergeordnete Prozesse fest. Verwenden Sie für bereitgestellte Anwendungen einen Secret Manager.

printf 'TokenLab API key: '
read -r -s TOKENLAB_API_KEY
printf '\n'
export TOKENLAB_API_KEY

Client installieren

pip install openai

Erste Anfrage senden

Für die meisten neuen Integrationen beginnen Sie mit Chat Completions unter POST /v1/chat/completions.

curl https://api.tokenlab.sh/v1/chat/completions \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-terra","messages":[{"role":"user","content":"Reply only with OK."}]}'

Speichern Sie ein SDK-Beispiel als quickstart.py, quickstart.mjs, main.go oder quickstart.php und führen Sie dann python quickstart.py, node quickstart.mjs, go run . oder php quickstart.php aus. Python, JavaScript und Go verwenden offizielle OpenAI SDKs; PHP verwendet den von der Community gepflegten OpenAI PHP client (PHP 8.2+).

Verwenden Sie POST /v1/responses nur, wenn Sie Responses-spezifisches Verhalten benötigen. Die Unterstützung für Responses-only-Felder hängt vom ausgewählten Modell ab.

Ergebnis bestätigen

Eine erfolgreiche Anfrage gibt eine nicht leere Antwort zurück. Öffnen Sie Runs im selben Workspace, um Modell, Status und Nutzung zu überprüfen. Bei Fehlern folgen Sie der Fehlerbehebung. Das Ändern des Modells oder das Hinzufügen von Streaming ist ein separater nächster Schritt im SDK-Leitfaden.

Warum gibt mein erster Aufruf 402 zurück?

Ob Ihr erster Aufruf funktioniert, hängt vom Guthaben ab, das unter Billing angezeigt wird. Während das Testguthaben-Angebot läuft, erhält ein berechtigtes neues Konto einmalig $0.25 für bis zu 10 Aufrufe innerhalb von 7 Tagen; der elfte Aufruf gibt 402 zurück und meldet, dass die kostenlosen Testaufrufe aufgebraucht sind, selbst wenn noch ein kleines Guthaben vorhanden ist. Ein Konto mit einem Guthaben von $0 erhält den HTTP-Status 402 mit dem Fehlercode insufficient_balance. Laden Sie mindestens $5 unter Billing auf; $5 ist der Mindestbetrag. Senden Sie dann dieselbe Anfrage erneut. Sie benötigen keinen neuen API-Key: Der von Ihnen erstellte Key funktioniert weiterhin, sobald das Guthaben die Anfrage abdeckt.

Ein erster Testaufruf kostet sehr wenig. Eine Beispielanfrage an deepseek-v4.1-flash kostet weit unter $0.01.

Wenn Sie bereits über ein Guthaben verfügen, gibt die 402-Meldung an, wie viel die Anfrage benötigt und wie hoch Ihr Guthaben ist. TokenLab reserviert die Kosten für die vollständigen max_tokens, bevor der Aufruf beginnt, daher kann eine lange Eingabe oder ein großer max_tokens-Wert mehr als ein kleines Guthaben erfordern. Unter /v1/chat/completions und /v1/messages gibt die Meldung auch den Wert an, auf den Sie max_tokens reduzieren können, falls ein kleinerer Wert ausreichen würde. Wenn die Eingabe allein mehr kostet als Ihr Guthaben, werden Sie aufgefordert, die Eingabe zu verkürzen.

Ein Key, der sein eigenes Ausgabenlimit erreicht, gibt ebenfalls 402 mit dem Code quota_exceeded zurück. Erhöhen oder entfernen Sie das Limit unter API Keys. Informationen zur Behandlung von 402 im Code finden Sie unter Fehlerbehandlung.

Weiterbauen

Auf dieser Seite