Authentification

Sécurisez chaque requête avec un jeton porteur en utilisant votre clé API EmpirioLabs

Toutes les requêtes API EmpirioLabs doivent inclure un jeton porteur dans l’en-tête Authorization.

Format de clé API

Les clés API utilisent le préfixe sk-empiriolabs-. Vous pouvez générer jusqu’à 50 clés API par compte depuis le tableau de bord.

1Authorization: Bearer sk-empiriolabs-...

Format d’en-tête

Incluez l’en-tête sur chaque demande:

$curl "https://api.empiriolabs.ai/v1/models" \
> -H "Authorization: Bearer sk-empiriolabs-your_key_here"

Limites de taux

Chaque compte commence avec des limites de taux par défaut:

LimitePar défaut
Demandes par minute50 tours par minute
Jetons par minute2 000 000 TPM

Si vous avez besoin de plafonds plus élevés, envoyez un e-mail à support@empiriolabs.ai. Voir Limites et clés API pour tous les détails.

Pratiques recommandées

  • Générer des clés API séparées pour la production, la mise en scène et le développement
  • Faites pivoter les clés régulièrement et immédiatement après une exposition suspectée
  • Stockez les clés dans un gestionnaire de secrets ou une plateforme de déploiement - jamais dans du code côté client, des dépôts publics ou des journaux
  • Supprimez rapidement les clés inutilisées du tableau de bord

Testez vos références

Un moyen rapide de vérifier que votre clé fonctionne bien:

$curl "https://api.empiriolabs.ai/v1/models" \
> -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Une réponse 200 avec le catalogue de modèles confirme que votre clé est valide et que votre compte a été configuré correctement.

Réponses d’authentification courantes

Code de statutSignificationQue faire
401 UnauthorizedLe jeton est manquant, déformé ou non retrouvéVérifiez le format Authorization: Bearer sk-empiriolabs-... de l’en-tête et que la clé existe dans votre tableau de bord
402 Payment RequiredLe compte ne donne pas assez de créditsRechargez les crédits sur le tableau de bord Page facturation
429 Too Many RequestsLimite de vitesse dépassée (valeur par défaut de 50 tr/min)Réessayez avec un recul exponentiel et revoyez votre volume de requêtes