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-keyPour les requêtes /v1/messages compatibles avec Anthropic, vous pouvez également utiliser :
x-api-key: sk-your-api-keyLes 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-tokenUtilisez 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
- Connectez-vous à la Console TokenLab
- Ouvrez API Keys
- Créez une nouvelle clé
- Donnez-lui un nom descriptif
- 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ètre | Description |
|---|---|
| Limite de dépenses | No 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és | La 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 livraison | Auto, 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. |
| Expiration | Après ce délai, la clé renvoie 401 expired_api_key. |
| Statut | Une 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 statut | Type | Code | Description |
|---|---|---|---|
| 401 | invalid_api_key | invalid_api_key | La clé API est manquante, invalide, inactive ou révoquée |
| 401 | expired_api_key | expired_api_key | La clé a expiré |
| 402 | insufficient_balance | insufficient_balance | Le solde du compte est insuffisant |
| 402 | quota_exceeded | quota_exceeded | Limite d'utilisation de la clé API atteinte |
| 403 | permission_error | model_not_allowed | La clé n'est pas autorisée à utiliser le modèle demandé |
| 403 | permission_error | user_suspended, account_restricted | Le compte ne peut pas utiliser l'API |
| 429 | rate_limit_exceeded | rate_limit_exceeded | Trop 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"
}
}