Authentifizierung

API-Schlüssel

Alle TokenLab API-Anfragen erfordern einen API-Schlüssel. Für OpenAI-kompatible Endpunkte senden Sie ihn wie folgt:

Authorization: Bearer sk-your-api-key

Für Anthropic-kompatible /v1/messages-Anfragen können Sie außerdem Folgendes verwenden:

x-api-key: sk-your-api-key

Ihren API-Schlüssel erhalten

Melden Sie sich in Ihrem TokenLab Dashboard an
Öffnen Sie API Keys
Erstellen Sie einen neuen Schlüssel
Geben Sie ihm einen aussagekräftigen Namen
Kopieren Sie ihn sofort, da er nur einmal angezeigt wird

Legen Sie API-Schlüssel niemals in clientseitigem Code offen
Committen Sie API-Schlüssel niemals in die Versionsverwaltung
Verwenden Sie Umgebungsvariablen oder einen Secret-Manager
Rotieren Sie Schlüssel regelmäßig
Löschen Sie nicht verwendete Schlüssel

API-Schlüssel verwenden

curl https://api.tokenlab.sh/v1/responses \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "input": "Hello!"
  }'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("TOKENLAB_API_KEY"),
    base_url="https://api.tokenlab.sh/v1"
)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.TOKENLAB_API_KEY,
  baseURL: 'https://api.tokenlab.sh/v1'
});

Funktionen von API-Schlüsseln

Nutzungslimits

Sie können für jeden API-Schlüssel ein Nutzungslimit festlegen:

Einstellung	Beschreibung
No Limit	Schlüssel verwendet Ihr Kontoguthaben ohne Einschränkungen
Fixed Limit	Schlüssel funktioniert nicht mehr, nachdem der angegebene Betrag erreicht wurde

Schlüsselpräfix

Alle TokenLab API-Schlüssel beginnen mit sk-.

Anthropic-Kompatibilität

Für den Endpunkt /v1/messages funktioniert der Header im Anthropic-Stil wie erwartet:

curl https://api.tokenlab.sh/v1/messages \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Verwenden Sie Authorization: Bearer ... für OpenAI-kompatible Endpunkte wie /v1/responses, /v1/chat/completions, /v1/models und die meisten anderen TokenLab-Routen.

Fehlerantworten

Statuscode	Typ	Code	Beschreibung
401	`invalid_api_key`	`invalid_api_key`	Fehlender oder ungültiger API-Schlüssel
401	`expired_api_key`	`expired_api_key`	API-Schlüssel wurde widerrufen
402	`insufficient_balance`	`insufficient_balance`	Kontoguthaben ist unzureichend
402	`quota_exceeded`	`quota_exceeded`	Nutzungslimit des API-Schlüssels erreicht

Beispiel:

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}

Erste Schritte

Kernleitfäden

Medienleitfäden

Authentifizierung

API-Schlüssel

Ihren API-Schlüssel erhalten

API-Schlüssel verwenden

Funktionen von API-Schlüsseln

Nutzungslimits

Schlüsselpräfix

Anthropic-Kompatibilität

Fehlerantworten

​API-Schlüssel

​Ihren API-Schlüssel erhalten

​API-Schlüssel verwenden

​Funktionen von API-Schlüsseln

​Nutzungslimits

​Schlüsselpräfix

​Anthropic-Kompatibilität

​Fehlerantworten

API-Schlüssel

Ihren API-Schlüssel erhalten

API-Schlüssel verwenden

Funktionen von API-Schlüsseln

Nutzungslimits

Schlüsselpräfix

Anthropic-Kompatibilität

Fehlerantworten