TokenLab

Gestion

Créer une clé API

Créer une clé API pour l'Espace de travail actuel.

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

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

ChampTypeDéfaut / LimitesNotes
namestringfacultatif, par défaut Default Key, longueur 1-50Nom d'affichage, tronqué côté serveur
limitAmountnumber | string | null0–100000 USDnull 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é.
limitCurrencyenumpar défaut USDUSD uniquement. Envoyer CNY renvoie 400 currency_retired.
modelsstring[]par défaut []Liste blanche de modèles optionnelle
deliveryPolicystring | nullauto, verified, official, nullnull hérite de la politique de livraison de l'Espace de travail.
expiresAtstring | nullDate/heure RFC3339null signifie aucune expiration

Notes

  • Les champs monétaires sont en USD uniquement. Les saisies CNY sont obsolètes et renvoient 400 currency_retired.

  • models: [] n'ajoute aucune restriction de modèle au niveau de la clé.

  • limitAmount: 0 crée une clé valide mais qui ne peut consommer aucun quota tant qu'elle n'est pas mise à jour.

Exemple

Requête

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-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.

Exemple de réponse

Réponse

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-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

keystring
Valeur secrète complète de la clé API. Elle n'est renvoyée qu'une seule fois lors de la création.
idstring
Identifiant de la clé API utilisé dans les appels ultérieurs à l'API de gestion.
namestring
Nom d'affichage de la clé API.
key_prefixstring
Préfixe non secret de la clé pour l'affichage et le support.
statusstring
L'un des états suivants : active, inactive, suspended ou revoked.
limit_amountnumber | null
Plafond de dépenses en USD sous forme de nombre JSON pour l'affichage. null signifie illimité.
limit_amount_decimalstring | null
Plafond de dépenses exact en USD sous forme de chaîne décimale. null signifie illimité.
used_amountnumber
Utilisation accumulée en USD sous forme de nombre JSON pour l'affichage.
used_amount_decimalstring
Utilisation accumulée exacte en USD sous forme de chaîne décimale.
modelsstring[]
Liste blanche de modèles par clé. Un tableau vide signifie aucune restriction de modèle supplémentaire au niveau de la clé.
delivery_policystring | null
auto, verified, official, null. null hérite de la politique de livraison de l'Espace de travail.
expires_atstring | null
Horodatage ISO d'expiration de la clé, ou null si aucune expiration.
last_used_atstring | null
Horodatage ISO de la dernière utilisation, ou null si non utilisée.
created_atstring
Horodatage ISO de création.

Autorisation

ManagementTokenAuth
AuthorizationBearer <token>

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