Verwaltung

API-Key erstellen

Erstellt einen neuen Benutzer-API-Key für die aktuelle Organisation.

POSThttps://api.tokenlab.sh/v1/management/api-keys

Übersicht

Dieser Endpunkt erstellt einen neuen API-Key vom Typ type=user in der Organisation, die mit dem aktuellen Management-Token verknüpft ist.

Request-Body

FeldTypStandard / GrenzenBeschreibung
namestringoptional, Standard Default Key, Länge 1-50Anzeigename; führende und nachgestellte Leerzeichen werden serverseitig entfernt
limitAmountnumber | string | null0–100000 USDnull bedeutet unbegrenzt; 0 verhindert Ausgaben. Dezimalstrings erlauben bis zu 6 Nachkommastellen. Bei der Erstellung bedeutet das Weglassen unbegrenzt.
limitCurrencyenumStandardwert USDNur USD. Das Senden von CNY gibt 400 currency_retired zurück.
modelsstring[]Standard []Optionale Allowlist für logische Modelle
deliveryPolicystring | nullauto, verified, official, nullnull übernimmt die Zustellrichtlinie des Workspace.
expiresAtstring | nullRFC3339-Datetimenull bedeutet ohne Ablaufzeit

Hinweise

  • Geldbetragsfelder unterstützen ausschließlich USD. CNY-Eingaben sind außer Betrieb genommen und geben 400 currency_retired zurück.

  • Der vollständige API-Key-Wert wird nur einmal in der Antwort angezeigt.

  • models: [] bedeutet, dass keine zusätzliche Modellbeschränkung über die Organisationsrichtlinie hinaus gilt.

  • limitAmount: 0 erstellt einen gültigen Key, der zunächst kein Kontingent verbrauchen kann.

Beispiel

Anfrage

cURL
curl -X POST "https://api.tokenlab.sh/v1/management/api-keys" \
  -H "Authorization: Bearer mt-your-management-token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Backend Worker",
    "limitAmount": 500,
    "models": ["veo3.1", "kling-3.0-video"],
    "expiresAt": "2026-12-31T23:59:59Z"
  }'

Anfrage / Antwort

Diese Seite enthält das OpenAPI-Schema und kopierbare Anfragebeispiele. Senden Sie Verwaltungsanfragen mit einem Management Token über Ihr Terminal oder Ihren Client; direktes Senden ist auf dieser Seite nicht verfügbar.

Antwortbeispiel

Antwort

201 Created
{
  "id": "key_abc123def456",
  "name": "Backend Worker",
  "key": "sk-live-redacted",
  "key_prefix": "sk-live...",
  "status": "active",
  "limit_amount": 500,
  "limit_amount_decimal": "500",
  "used_amount": 0,
  "used_amount_decimal": "0",
  "models": [
    "veo3.1",
    "kling-3.0-video"
  ],
  "expires_at": "2026-12-31T23:59:59.000Z",
  "last_used_at": null,
  "created_at": "2026-07-08T03:00:00.000Z",
  "delivery_policy": null
}

Wichtige Felder

keystring
Vollständiger geheimer API-Schlüsselwert. Wird nur einmal bei der Erstellung zurückgegeben.
idstring
API-Schlüssel-ID für nachfolgende Management-API-Aufrufe.
namestring
Anzeigename des API-Schlüssels.
key_prefixstring
Nicht geheimer Schlüsselpräfix für Anzeige und Support.
statusstring
Einer der Werte active, inactive, suspended oder revoked.
limit_amountnumber | null
Ausgabenlimit in USD als JSON-Zahl für die Anzeige. null bedeutet unbegrenzt.
limit_amount_decimalstring | null
Exaktes Ausgabenlimit in USD als Dezimalzeichenfolge. null bedeutet unbegrenzt.
used_amountnumber
Kumulierte Nutzungskosten in USD als JSON-Zahl für die Anzeige.
used_amount_decimalstring
Exakte kumulierte Nutzungskosten in USD als Dezimalzeichenfolge.
modelsstring[]
Liste zulässiger Modelle pro Schlüssel. Ein leeres Array bedeutet, dass keine zusätzliche Modellbeschränkung auf Schlüsselebene gilt.
delivery_policystring | null
auto, verified, official, null. null übernimmt die Zustellrichtlinie des Workspace.
expires_atstring | null
ISO-Zeitstempel, zu dem der Schlüssel abläuft, oder null ohne Ablaufdatum.
last_used_atstring | null
ISO-Zeitstempel der letzten Nutzung oder null, wenn noch nicht verwendet.
created_atstring
ISO-Zeitstempel der Erstellung.

Autorisierung

ManagementTokenAuth
AuthorizationBearer <token>

Management-Token-Authentifizierung. Erstellen oder verwalten Sie Management-Token unter Dashboard > API > Management Tokens.

Ort: header

Anfragekörper

application/json

Antwort

application/json

application/json

application/json

application/json