TokenLab

Démarrage

Authentification

Authentifiez les requêtes API de TokenLab avec une clé API

Clés API

Les appels de modèles et les ressources privées nécessitent une clé API. Les endpoints de découverte publics tels que GET /v1/models et GET /v1/models/{model} fonctionnent sans clé. Une réponse de découverte réussie ne vérifie pas que votre clé fonctionne ; suivez le guide de démarrage rapide (Quickstart) pour envoyer une requête de modèle. Utilisez la clé complète enregistrée ; le préfixe dans la liste des clés ne permet pas l'authentification.

Pour les endpoints compatibles avec OpenAI, envoyez-la comme suit :

Authorization: Bearer sk-your-api-key

Pour les requêtes /v1/messages compatibles avec Anthropic, vous pouvez également utiliser :

x-api-key: sk-your-api-key

Les requêtes /v1beta/* compatibles avec Gemini acceptent également x-goog-api-key: sk-your-api-key. Préférez un en-tête plutôt que le paramètre de requête ?key=, car les URLs finissent souvent dans les journaux.

Jetons de gestion (Management Tokens)

Les endpoints de l'API de gestion utilisent un type de jeton distinct :

Authorization: Bearer mt-your-management-token

Utilisez les jetons de gestion uniquement avec les endpoints /v1/management/*. Ouvrez API → Tokens pour l'espace de travail sélectionné afin de créer ou de remplacer un jeton. Enregistrez le jeton complet lorsqu'il est affiché ; il n'est visible qu'une seule fois après sa création ou son remplacement.

Les jetons de gestion ne peuvent pas être utilisés pour l'inférence de modèles, et les clés API standard sk-... ne peuvent pas être utilisées pour l'API de gestion.

Obtenir une clé API

  1. Connectez-vous à la Console TokenLab
  2. Ouvrez API Keys
  3. Créez une nouvelle clé
  4. Donnez-lui un nom descriptif
  5. Copiez-la immédiatement car elle n'est affichée qu'une seule fois
  • N'exposez jamais les clés API dans le code côté client
  • Ne committez jamais les clés API dans le contrôle de version
  • Utilisez des variables d'environnement ou un gestionnaire de secrets
  • Faites pivoter les clés périodiquement
  • Supprimez les clés inutilisées

Utiliser une clé API

Consultez le Démarrage rapide pour les variables d'environnement et une première requête complète. Utilisez le SDK correspondant au format d'API choisi ; gardez les clés sur le serveur.

Paramètres des clés

Vous pouvez définir ces paramètres pour chaque clé API dans la Console, et via l'API de gestion :

ParamètreDescription
Limite de dépensesNo limit permet à la clé d'utiliser le solde de l'espace de travail. Fixed limit fait en sorte que la clé renvoie 402 quota_exceeded une fois le montant atteint.
Modèles autorisésLa clé ne peut appeler que ces modèles. Les autres modèles renvoient 403 model_not_allowed. Vide signifie aucune restriction au niveau de la clé.
Option de livraisonAuto, Verified ou Official pour les requêtes provenant de cette clé. Vide utilise la valeur par défaut de l'espace de travail. Voir Facturation et tarification.
ExpirationAprès ce délai, la clé renvoie 401 expired_api_key.
StatutUne clé inactive (en pause) renvoie 401 invalid_api_key. Une clé revoked ne peut plus être réactivée.

Préfixe de clé

Toutes les clés API TokenLab commencent par sk-.

Réponses d'erreur

Code de statutTypeCodeDescription
401invalid_api_keyinvalid_api_keyLa clé API est manquante, invalide, inactive ou révoquée
401expired_api_keyexpired_api_keyLa clé a expiré
402insufficient_balanceinsufficient_balanceLe solde du compte est insuffisant
402quota_exceededquota_exceededLimite d'utilisation de la clé API atteinte
403permission_errormodel_not_allowedLa clé n'est pas autorisée à utiliser le modèle demandé
403permission_erroruser_suspended, account_restrictedLe compte ne peut pas utiliser l'API
429rate_limit_exceededrate_limit_exceededTrop de tentatives d'authentification échouées depuis une adresse IP. Attendez Retry-After et corrigez la clé ; ne bouclez pas sur 401

Exemple :

{
  "error": {
    "message": "Invalid API key",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}

Sur cette page