Clés API
Créez, restreignez et faites tourner les clés avec lesquelles votre code s'authentifie. Une clé est le seul identifiant dont la passerelle a besoin : la même clé pour tous les modèles et tous les endpoints.
Dans la barre latérale de la console (elle apparaît dès que la fonctionnalité s'applique à votre compte) : API keys Ouvrir ↗
Étapes
- Ouvrez API keys et appuyez sur Create key.
- Donnez-lui un nom que vous reconnaîtrez dans six mois : c'est par le nom que vous distinguerez les clés lors d'une rotation.
- Définissez les limites qu'elle doit porter : un quota de dépense avec un intervalle de réinitialisation, une liste de modèles autorisés, une liste d'IP autorisées et une date d'expiration. Tout est optionnel : une clé qui n'en a aucune peut appeler n'importe quel modèle auquel votre espace de travail a accès.
- Copiez la clé immédiatement et placez-la dans votre gestionnaire de secrets. Envoyez-la ensuite sous la forme
Authorization: Bearer <key>.
Limites et pièges
- Une clé n'est affichée qu'une seule fois. Il n'existe aucun moyen de l'afficher à nouveau : si elle est perdue, supprimez-la et créez-en une autre.
- La suppression d'une clé prend effet immédiatement. Pour une rotation, créez la nouvelle clé, déployez-la, puis supprimez l'ancienne, dans cet ordre.
- Les clés appartiennent à un espace de travail. Changer d'espace de travail change les clés visibles, et une clé ne franchit jamais cette frontière.
- Une liste d'IP autorisées est une liste fixe définie sur la clé. Pour approuver plutôt les nouvelles adresses au fur et à mesure qu'elles apparaissent, activez les IP de confiance pour l'espace de travail ; une clé qui a une liste continue de n'appliquer que la sienne.
Référence API pour la même fonctionnalité : Clés API