TokenLab

Gestion

API de gestion

Consultez les soldes de votre Workspace, gérez les clés API et récupérez les données d'utilisation et de facturation

Utilisez l'API de gestion depuis votre propre backend ou via automatisation pour gérer un Workspace TokenLab. Elle utilise un jeton de gestion (management token), de sorte que le programme n'a pas besoin d'une clé API classique.

Créez un jeton de gestion dans Tableau de bord → API → Jetons de gestion :

Authorization: Bearer mt-your-management-token

Les jetons de gestion et les clés API ont des rôles différents. Utilisez mt-... uniquement avec /v1/management/*. Utilisez sk-... avec les API de modèles telles que /v1/responses.

Endpoints

EndpointMéthodeUtilisation
/v1/management/balanceGETObtenir le solde du Workspace
/v1/management/api-keysGETLister les clés API
/v1/management/api-keysPOSTCréer une clé API
/v1/management/api-keys/{keyId}PATCHModifier son nom, sa limite, ses modèles, son expiration ou son statut
/v1/management/api-keys/{keyId}/usageGETObtenir les enregistrements d'utilisation individuels
/v1/management/api-keys/{keyId}/billingGETObtenir un résumé de facturation

Clés API

  • Le secret complet d'une nouvelle clé n'apparaît que dans la réponse de création.
  • models: [] n'ajoute aucune restriction de modèle au niveau de la clé.
  • limitAmount: null signifie illimité. 0 empêche la clé d'engendrer des dépenses.
  • Les montants sont en USD. L'envoi de CNY renvoie 400 currency_retired.
  • inactive peut être réactivé. Utilisez revoked pour retirer une clé définitivement.

Utilisation et facturation

/usage renvoie des enregistrements paginés et prend en charge les filtres par modèle, créateur de modèle, scène et date. Les enregistrements réglés peuvent inclure billing_transaction_id ; enregistrez-le avec request_id lorsque vous devez faire correspondre une facturation à une requête.

/billing renvoie des totaux regroupés par modèle, créateur de modèle, scène et date. Cela n'inclut pas les rechargements de Workspace ni les factures.

Une endDate composée uniquement d'une date, telle que 2026-07-31, signifie 00:00 UTC au début de cette journée. Pour inclure la journée entière, passez la date suivante ou une heure au format RFC3339 telle que 2026-07-31T23:59:59Z.

Erreurs

Les erreurs utilisent l'objet error standard. Gérez-les par statut et par code.

StatutcodeSignification
400validation_errorUn champ ou un paramètre de requête est invalide
400invalid_model_accessUn modèle dans models n'est pas autorisé par la politique de modèles du Workspace
400currency_retiredlimitCurrency est CNY ; utilisez USD
401invalid_management_tokenLe jeton est manquant, mal formé ou révoqué
403organization_inactiveLe Workspace n'est pas actif
404not_foundLa clé API n'est pas dans ce Workspace
409api_key_revokedUne clé révoquée ne peut pas être réactivée ; créez une nouvelle clé
429report_busyTrop de rapports d'utilisation ou de facturation sont en cours. Réessayez après le délai indiqué dans Retry-After

Exemple

curl "https://api.tokenlab.sh/v1/management/balance" \
  -H "Authorization: Bearer mt-your-management-token"

Suivant

Sur cette page