TokenLab

Gestion

Créer une API Key

Crée une nouvelle API Key utilisateur pour l’organisation courante.

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

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

ChampTypeValeurs par défaut / limitesDescription
namestringfacultatif, valeur par défaut Default Key, longueur 1-50Nom affiché ; les espaces de début et de fin sont retirés côté serveur
limitAmountnumber | string | null0–100000 USDnull 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.
limitCurrencyenumvaleur par défaut USDUSD uniquement. L'envoi de CNY renvoie 400 currency_retired.
modelsstring[]valeur par défaut []Liste d’autorisation optionnelle des modèles logiques
deliveryPolicystring | nullauto, verified, official, nullnull hérite de la politique de livraison de l’espace de travail.
expiresAtstring | nulldatetime RFC3339null signifie sans date d’expiration

Notes

  • Les champs monétaires prennent uniquement en charge l’USD. Les entrées CNY sont abandonnées et renvoient 400 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: 0 crée une clé valide mais incapable de consommer du 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-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.

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

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 clé API utilisé dans les appels ultérieurs à l’API de gestion.
namestring
Nom d’affichage de la clé API.
key_prefixstring
Préfixe de clé non secret pour l’affichage et l’assistance.
statusstring
L’une des valeurs active, inactive, suspended ou revoked.
limit_amountnumber | null
Plafond de dépenses en USD renvoyé sous forme de nombre JSON pour l’affichage. null signifie aucune limite.
limit_amount_decimalstring | null
Plafond de dépenses exact en USD renvoyé sous forme de chaîne décimale. null signifie aucune limite.
used_amountnumber
Dépenses d’utilisation cumulées en USD renvoyées sous forme de nombre JSON pour l’affichage.
used_amount_decimalstring
Dépenses d’utilisation cumulées exactes en USD renvoyées sous forme de chaîne décimale.
modelsstring[]
Liste des modèles autorisés par clé. Un tableau vide signifie qu’aucune restriction de modèle supplémentaire ne s’applique 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 elle n’expire pas.
last_used_atstring | null
Horodatage ISO de la dernière utilisation, ou null si elle n’a jamais été 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