Erste Schritte

Authentifizierung

Authentifizieren Sie TokenLab API-Anfragen mit einem API-Key

API-Keys

Modellaufrufe und private Ressourcen erfordern einen API-Key. Öffentliche Discovery-Endpunkte wie GET /v1/models und GET /v1/models/{model} funktionieren ohne einen solchen. Eine erfolgreiche Discovery-Antwort bestätigt nicht, dass Ihr Key funktioniert; folgen Sie dem Quickstart, um eine Modellanfrage zu senden. Verwenden Sie den vollständigen gespeicherten Key; das Präfix in der Key-Liste kann nicht zur Authentifizierung verwendet werden.

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 auch Folgendes verwenden:

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

Gemini-kompatible /v1beta/* Anfragen akzeptieren ebenfalls x-goog-api-key: sk-your-api-key. Bevorzugen Sie einen Header gegenüber dem ?key= Query-Parameter, da URLs häufig in Logs landen.

Management Tokens

Management API-Endpunkte verwenden einen separaten Token-Typ:

Authorization: Bearer mt-your-management-token

Verwenden Sie Management Tokens nur mit /v1/management/* Endpunkten. Öffnen Sie API → Tokens für den ausgewählten Workspace, um ein Token zu erstellen oder zu ersetzen. Speichern Sie das vollständige Token, wenn es angezeigt wird; es wird nach der Erstellung oder dem Ersetzen nur einmal angezeigt.

Management Tokens können nicht für Modell-Inferenz verwendet werden, und standardmäßige sk-... API-Keys können nicht für die Management API verwendet werden.

Einen API-Key erhalten

  1. Melden Sie sich bei der TokenLab Console an
  2. Öffnen Sie API Keys
  3. Erstellen Sie einen neuen Key
  4. Geben Sie ihm einen beschreibenden Namen
  5. Kopieren Sie ihn sofort, da er nur einmal angezeigt wird
  • Geben Sie API-Keys niemals in clientseitigem Code preis
  • Committen Sie API-Keys niemals in die Versionsverwaltung
  • Verwenden Sie Umgebungsvariablen oder einen Secret Manager
  • Rotieren Sie Keys regelmäßig
  • Löschen Sie ungenutzte Keys

Einen API-Key verwenden

Siehe den Schnellstart für Umgebungsvariablen und eine vollständige erste Anfrage. Verwenden Sie das SDK, das zu Ihrem gewählten API-Format passt; bewahren Sie Keys auf dem Server auf.

Key-Einstellungen

Sie können diese für jeden API-Key in der Console sowie über die Management-API festlegen:

EinstellungBeschreibung
Spending limitNo limit erlaubt dem Key die Nutzung des Workspace-Guthabens. Fixed limit führt dazu, dass der Key 402 quota_exceeded zurückgibt, sobald der Betrag erreicht ist.
Allowed modelsDer Key kann nur diese Modelle aufrufen. Andere Modelle geben 403 model_not_allowed zurück. Leer bedeutet keine Einschränkung auf Key-Ebene.
Delivery optionAuto, Verified oder Official für Anfragen von diesem Key. Leer verwendet den Workspace-Standard. Siehe Abrechnung und Preise.
ExpirationNach dieser Zeit gibt der Key 401 expired_api_key zurück.
StatusEin inactive (pausierter) Key gibt 401 invalid_api_key zurück. Ein revoked Key kann nicht erneut aktiviert werden.

Key-Präfix

Alle TokenLab API-Keys beginnen mit sk-.

Fehlerantworten

Status CodeTypCodeBeschreibung
401invalid_api_keyinvalid_api_keyDer API-Key fehlt, ist ungültig, inaktiv oder widerrufen
401expired_api_keyexpired_api_keyDer Key ist abgelaufen
402insufficient_balanceinsufficient_balanceKontoguthaben ist unzureichend
402quota_exceededquota_exceededNutzungslimit des API-Keys erreicht
403permission_errormodel_not_allowedDer Key ist nicht berechtigt, das angeforderte Modell zu verwenden
403permission_erroruser_suspended, account_restrictedDas Konto kann die API nicht nutzen
429rate_limit_exceededrate_limit_exceededZu viele fehlgeschlagene Authentifizierungsversuche von einer IP-Adresse. Warten Sie auf Retry-After und korrigieren Sie den Key; führen Sie keine Schleifen bei 401 aus

Beispiel:

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

Auf dieser Seite