Verwaltung
API-Key erstellen
Erstellt einen neuen Benutzer-API-Key für die aktuelle Organisation.
Ü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
| Feld | Typ | Standard / Grenzen | Beschreibung |
|---|---|---|---|
name | string | optional, Standard Default Key, Länge 1-50 | Anzeigename; führende und nachgestellte Leerzeichen werden serverseitig entfernt |
limitAmount | number | string | null | 0–100000 USD | null bedeutet unbegrenzt; 0 verhindert Ausgaben. Dezimalstrings erlauben bis zu 6 Nachkommastellen. Bei der Erstellung bedeutet das Weglassen unbegrenzt. |
limitCurrency | enum | Standardwert USD | Nur USD. Das Senden von CNY gibt 400 currency_retired zurück. |
models | string[] | Standard [] | Optionale Allowlist für logische Modelle |
deliveryPolicy | string | null | auto, verified, official, null | null übernimmt die Zustellrichtlinie des Workspace. |
expiresAt | string | null | RFC3339-Datetime | null bedeutet ohne Ablaufzeit |
Hinweise
-
Geldbetragsfelder unterstützen ausschließlich USD.
CNY-Eingaben sind außer Betrieb genommen und geben400 currency_retiredzurü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: 0erstellt einen gültigen Key, der zunächst kein Kontingent verbrauchen kann.
Anfrage
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.
Antwort
{
"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
active, inactive, suspended oder revoked.null bedeutet unbegrenzt.null bedeutet unbegrenzt.auto, verified, official, null. null übernimmt die Zustellrichtlinie des Workspace.null ohne Ablaufdatum.null, wenn noch nicht verwendet.Autorisierung
ManagementTokenAuth 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