Gestion
Créer une API Key
Crée une nouvelle API Key utilisateur pour l’organisation courante.
Vue d’ensemble
Crée une nouvelle API Key type=user dans l’organisation associée au jeton de gestion courant.
Corps de la requête
| Champ | Type | Valeurs par défaut / limites | Description |
|---|---|---|---|
name | string | facultatif, valeur par défaut Default Key, longueur 1-50 | Nom affiché ; les espaces de début et de fin sont retirés côté serveur |
limitAmount | number | string | null | 0–100000 USD | null signifie sans limite ; 0 empêche toute dépense. Les chaînes décimales acceptent jusqu’à 6 décimales. À la création, omettre ce champ signifie sans limite. |
limitCurrency | enum | valeur par défaut USD | USD uniquement. L'envoi de CNY renvoie 400 currency_retired. |
models | string[] | valeur par défaut [] | Liste d’autorisation optionnelle des modèles logiques |
deliveryPolicy | string | null | auto, verified, official, null | null hérite de la politique de livraison de l’espace de travail. |
expiresAt | string | null | datetime RFC3339 | null signifie sans date d’expiration |
Notes
-
Les champs monétaires prennent uniquement en charge l’USD. Les entrées
CNYsont abandonnées et renvoient400 currency_retired. -
La valeur complète de l’API Key n’est affichée qu’une seule fois dans la réponse.
-
models: []signifie qu’aucune restriction supplémentaire n’est appliquée au-delà de la politique d’organisation. -
limitAmount: 0crée une clé valide mais incapable de consommer du quota tant qu’elle n’est pas mise à jour.
Requête
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"
}'Requête / Réponse
Cette page fournit le schéma OpenAPI et des exemples de requêtes à copier. Envoyez les requêtes de gestion depuis votre terminal ou votre client avec un Management Token ; l’envoi direct n’est pas disponible sur cette page.
Réponse
{
"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
}Champs importants
active, inactive, suspended ou revoked.null signifie aucune limite.null signifie aucune limite.auto, verified, official, null. null hérite de la politique de livraison de l’espace de travail.null si elle n’expire pas.null si elle n’a jamais été utilisée.Autorisation
ManagementTokenAuth Authentification par jeton de gestion. Créez ou gérez vos jetons de gestion dans Dashboard > API > Management Tokens.
Emplacement: header
Corps de la requête
application/json
Réponse
application/json
application/json
application/json
application/json