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-token

Management-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

EndpunktMethodeVerwendung
/v1/management/balanceGETWorkspace-Guthaben abrufen
/v1/management/api-keysGETAPI-Keys auflisten
/v1/management/api-keysPOSTEinen API-Key erstellen
/v1/management/api-keys/{keyId}PATCHName, Limit, Modelle, Ablaufdatum oder Status ändern
/v1/management/api-keys/{keyId}/usageGETEinzelne Nutzungsdatensätze abrufen
/v1/management/api-keys/{keyId}/billingGETEine 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: null bedeutet unbegrenzt. 0 verhindert, dass durch den Key Kosten entstehen.
  • Beträge verwenden USD. Das Senden von CNY gibt 400 currency_retired zurück.
  • inactive kann wieder aktiviert werden. Verwenden Sie revoked, 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.

StatuscodeBedeutung
400validation_errorEin Feld oder Abfrageparameter ist ungültig
400invalid_model_accessEin Modell in models ist laut der Modellrichtlinie des Workspaces nicht zulässig
400currency_retiredlimitCurrency ist CNY; verwenden Sie USD
401invalid_management_tokenDas Token fehlt, ist fehlerhaft oder wurde widerrufen
403organization_inactiveDer Workspace ist nicht aktiv
404not_foundDer API-Key befindet sich nicht in diesem Workspace
409api_key_revokedEin widerrufener Key kann nicht wieder aktiviert werden; erstellen Sie einen neuen Key
429report_busyZu 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"

Nächste Schritte

Auf dieser Seite