Gestion
Créer une clé API
Créer une clé API pour l'Espace de travail actuel.
Vue d'ensemble
Créez une clé API dans l'Espace de travail associé au jeton de gestion (management token). Le secret complet n'apparaît qu'une seule fois, dans cette réponse.
Corps de la requête
| Champ | Type | Défaut / Limites | Notes |
|---|---|---|---|
name | string | facultatif, par défaut Default Key, longueur 1-50 | Nom d'affichage, tronqué côté serveur |
limitAmount | number | string | null | 0–100000 USD | null signifie illimité ; 0 empêche les dépenses. Les chaînes décimales supportent jusqu'à 6 décimales. Omettre ce champ lors de la création d'une clé signifie illimité. |
limitCurrency | enum | par défaut USD | USD uniquement. Envoyer CNY renvoie 400 currency_retired. |
models | string[] | par défaut [] | Liste blanche de modèles optionnelle |
deliveryPolicy | string | null | auto, verified, official, null | null hérite de la politique de livraison de l'Espace de travail. |
expiresAt | string | null | Date/heure RFC3339 | null signifie aucune expiration |
Notes
-
Les champs monétaires sont en USD uniquement. Les saisies
CNYsont obsolètes et renvoient400 currency_retired. -
models: []n'ajoute aucune restriction de modèle au niveau de la clé. -
limitAmount: 0crée une clé valide mais qui ne peut consommer aucun 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-v3.0"],
"expiresAt": "2026-12-31T23:59:59Z"
}'Requête / Réponse
Cette page fournit le schéma OpenAPI et des exemples de requête copiables. Envoyez les requêtes de gestion depuis votre terminal ou client avec un Jeton de gestion ; 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-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
}Champs importants
active, inactive, suspended ou revoked.null signifie illimité.null signifie illimité.auto, verified, official, null. null hérite de la politique de livraison de l'Espace de travail.null si aucune expiration.null si non 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