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-keyFür Anthropic-kompatible /v1/messages Anfragen können Sie auch Folgendes verwenden:
x-api-key: sk-your-api-keyGemini-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-tokenVerwenden 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
- Melden Sie sich bei der TokenLab Console an
- Öffnen Sie API Keys
- Erstellen Sie einen neuen Key
- Geben Sie ihm einen beschreibenden Namen
- 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:
| Einstellung | Beschreibung |
|---|---|
| Spending limit | No 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 models | Der Key kann nur diese Modelle aufrufen. Andere Modelle geben 403 model_not_allowed zurück. Leer bedeutet keine Einschränkung auf Key-Ebene. |
| Delivery option | Auto, Verified oder Official für Anfragen von diesem Key. Leer verwendet den Workspace-Standard. Siehe Abrechnung und Preise. |
| Expiration | Nach dieser Zeit gibt der Key 401 expired_api_key zurück. |
| Status | Ein 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 Code | Typ | Code | Beschreibung |
|---|---|---|---|
| 401 | invalid_api_key | invalid_api_key | Der API-Key fehlt, ist ungültig, inaktiv oder widerrufen |
| 401 | expired_api_key | expired_api_key | Der Key ist abgelaufen |
| 402 | insufficient_balance | insufficient_balance | Kontoguthaben ist unzureichend |
| 402 | quota_exceeded | quota_exceeded | Nutzungslimit des API-Keys erreicht |
| 403 | permission_error | model_not_allowed | Der Key ist nicht berechtigt, das angeforderte Modell zu verwenden |
| 403 | permission_error | user_suspended, account_restricted | Das Konto kann die API nicht nutzen |
| 429 | rate_limit_exceeded | rate_limit_exceeded | Zu 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"
}
}