Verwaltung
API-Key erstellen
Erstellen Sie einen API-Key für den aktuellen Workspace.
Übersicht
Erstellen Sie einen API-Key in dem Workspace, der mit dem Management-Token verknüpft ist. Das vollständige Secret wird nur einmalig in dieser Antwort angezeigt.
Request-Body
| Feld | Typ | Standard / Limits | Hinweise |
|---|---|---|---|
name | string | optional, Standard Default Key, Länge 1-50 | Anzeigename, serverseitig getrimmt |
limitAmount | number | string | null | 0–100000 USD | null bedeutet unbegrenzt; 0 verhindert Ausgaben. Dezimal-Strings unterstützen bis zu 6 Dezimalstellen. Das Weglassen dieses Felds beim Erstellen eines Keys bedeutet unbegrenzt. |
limitCurrency | enum | Standard USD | Nur USD. Das Senden von CNY gibt 400 currency_retired zurück. |
models | string[] | Standard [] | Optionale Modell-Allowlist |
deliveryPolicy | string | null | auto, verified, official, null | null erbt die Delivery-Policy des Workspace. |
expiresAt | string | null | RFC3339 datetime | null bedeutet kein Ablaufdatum |
Hinweise
-
Währungsfelder unterstützen ausschließlich USD.
CNY-Eingaben sind veraltet und geben400 currency_retiredzurück. -
models: []fügt keine Modellbeschränkung auf Key-Ebene hinzu. -
limitAmount: 0erstellt einen Key, der gültig ist, aber kein Kontingent ausgeben kann, bis er aktualisiert wird.
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-v3.0"],
"expiresAt": "2026-12-31T23:59:59Z"
}'Anfrage / Antwort
Diese Seite bietet das OpenAPI-Schema und kopierbare Request-Beispiele. Senden Sie Management-Requests von Ihrem Terminal oder Client mit einem Management-Token; das direkte 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-v3.0"
],
"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 erbt die Delivery-Policy des Workspace.null für kein Ablaufdatum.null, wenn ungenutzt.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