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-tokenLes 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
| Endpoint | Méthode | Utilisation |
|---|---|---|
/v1/management/balance | GET | Obtenir le solde du Workspace |
/v1/management/api-keys | GET | Lister les clés API |
/v1/management/api-keys | POST | Créer une clé API |
/v1/management/api-keys/{keyId} | PATCH | Modifier son nom, sa limite, ses modèles, son expiration ou son statut |
/v1/management/api-keys/{keyId}/usage | GET | Obtenir les enregistrements d'utilisation individuels |
/v1/management/api-keys/{keyId}/billing | GET | Obtenir 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: nullsignifie illimité.0empêche la clé d'engendrer des dépenses.- Les montants sont en USD. L'envoi de
CNYrenvoie400 currency_retired. inactivepeut être réactivé. Utilisezrevokedpour 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.
| Statut | code | Signification |
|---|---|---|
| 400 | validation_error | Un champ ou un paramètre de requête est invalide |
| 400 | invalid_model_access | Un modèle dans models n'est pas autorisé par la politique de modèles du Workspace |
| 400 | currency_retired | limitCurrency est CNY ; utilisez USD |
| 401 | invalid_management_token | Le jeton est manquant, mal formé ou révoqué |
| 403 | organization_inactive | Le Workspace n'est pas actif |
| 404 | not_found | La clé API n'est pas dans ce Workspace |
| 409 | api_key_revoked | Une clé révoquée ne peut pas être réactivée ; créez une nouvelle clé |
| 429 | report_busy | Trop 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"