Passer au contenu principal

​
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
namestringrequis, 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 | nullmin. 0, entrée max. 1000000null ou omis = illimité, 0 = quota nul. Les valeurs positives sont normalisées vers un plafond stocké qui ne peut pas dépasser l’équivalent de 100000 USD.
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
expiresAtstring | nulldatetime RFC3339null signifie sans date d’expiration

​
Notes

  • Les champs monétaires sont réservés au USD. Les entrées CNY sont obsolètes 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

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

Utilisez le panneau OpenAPI interactif ci-dessus pour obtenir le schéma exact et les champs de réponse.

​
Response example

{
  "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"
}

​
Important fields

​
key
string
Full secret API key value. It is returned only once on creation.
​
id
string
API key identifier used in follow-up Management API calls.
​
name
string
Display name for the API key.
​
key_prefix
string
Non-secret key prefix for display and support.
​
status
string
One of active, inactive, or revoked.
​
limit_amount
number | null
Spending cap in USD as a JSON number for display. null means unlimited.
​
limit_amount_decimal
string | null
Exact spending cap in USD as a decimal string. null means unlimited.
​
used_amount
number
Accumulated usage in USD as a JSON number for display.
​
used_amount_decimal
string
Exact accumulated usage in USD as a decimal string.
​
models
string[]
Per-key model allowlist. Empty array means no additional key-level model restriction.
​
expires_at
string | null
ISO timestamp when the key expires, or null for no expiry.
​
last_used_at
string | null
ISO timestamp for the most recent use, or null when unused.
​
created_at
string
ISO creation timestamp.