Verwaltung
Management-API
Workspace-Guthaben prüfen, API-Keys verwalten sowie Nutzung und Abrechnung abrufen
Verwenden Sie die Management-API aus Ihrem eigenen Backend oder Ihrer Automatisierung heraus, um einen TokenLab Workspace zu verwalten. Sie verwendet ein Management-Token, sodass das Programm keinen regulären API-Key benötigt.
Erstellen Sie ein Management-Token unter Dashboard → API → Management Tokens:
Authorization: Bearer mt-your-management-tokenManagement-Tokens und API-Keys haben unterschiedliche Rollen. Verwenden Sie mt-... ausschließlich mit /v1/management/*. Verwenden Sie sk-... mit Modell-APIs wie /v1/responses.
Endpunkte
| Endpunkt | Methode | Verwendung |
|---|---|---|
/v1/management/balance | GET | Workspace-Guthaben abrufen |
/v1/management/api-keys | GET | API-Keys auflisten |
/v1/management/api-keys | POST | Einen API-Key erstellen |
/v1/management/api-keys/{keyId} | PATCH | Name, Limit, Modelle, Ablaufdatum oder Status ändern |
/v1/management/api-keys/{keyId}/usage | GET | Einzelne Nutzungsdatensätze abrufen |
/v1/management/api-keys/{keyId}/billing | GET | Eine Abrechnungsübersicht abrufen |
API-Keys
- Das vollständige Secret eines neuen Keys wird nur in der Erstellungsantwort angezeigt.
models: []fügt keine Modellbeschränkung auf Key-Ebene hinzu.limitAmount: nullbedeutet unbegrenzt.0verhindert, dass durch den Key Kosten entstehen.- Beträge verwenden USD. Das Senden von
CNYgibt400 currency_retiredzurück. inactivekann wieder aktiviert werden. Verwenden Sierevoked, um einen Key dauerhaft zu deaktivieren.
Nutzung und Abrechnung
/usage gibt paginierte Datensätze zurück und unterstützt Filter nach Modell, Modellhersteller, Szene und Datum. Abgerechnete Datensätze können eine billing_transaction_id enthalten; speichern Sie diese zusammen mit request_id, wenn Sie eine Gebühr einer Anfrage zuordnen müssen.
/billing gibt Gesamtsummen zurück, gruppiert nach Modell, Modellhersteller, Szene und Datum. Aufladungen des Workspaces oder Rechnungen sind nicht enthalten.
Ein reines Datumsformat für endDate wie 2026-07-31 bedeutet 00:00 UTC zu Beginn dieses Tages. Um den gesamten Tag einzuschließen, übergeben Sie das Folgedatum oder eine RFC3339-Zeitangabe wie 2026-07-31T23:59:59Z.
Fehler
Fehler verwenden das standardmäßige error-Objekt. Behandeln Sie diese anhand von Status und code.
| Status | code | Bedeutung |
|---|---|---|
| 400 | validation_error | Ein Feld oder Abfrageparameter ist ungültig |
| 400 | invalid_model_access | Ein Modell in models ist laut der Modellrichtlinie des Workspaces nicht zulässig |
| 400 | currency_retired | limitCurrency ist CNY; verwenden Sie USD |
| 401 | invalid_management_token | Das Token fehlt, ist fehlerhaft oder wurde widerrufen |
| 403 | organization_inactive | Der Workspace ist nicht aktiv |
| 404 | not_found | Der API-Key befindet sich nicht in diesem Workspace |
| 409 | api_key_revoked | Ein widerrufener Key kann nicht wieder aktiviert werden; erstellen Sie einen neuen Key |
| 429 | report_busy | Zu viele Nutzungs- oder Abrechnungsberichte werden gleichzeitig ausgeführt. Wiederholen Sie den Vorgang nach Ablauf der Sekunden in Retry-After |
Beispiel
curl "https://api.tokenlab.sh/v1/management/balance" \
-H "Authorization: Bearer mt-your-management-token"