Clés API

Une clé API est l’identifiant utilisé pour appeler Glacier AI. Créez et gérez une clé par usage, chacune avec son quota, ses modèles, son groupe et ses restrictions d’origine.

Cliquez sur « Clés API » dans la navigation de gauche, ou accédez à /keys. La page affiche le nom de la clé, la clé masquée, l’état d’activation, l’utilisation du quota et le groupe, et permet de filtrer, copier, modifier, activer/désactiver et supprimer en lot. Le menu de ligne permet aussi de copier les informations de connexion, d’ouvrir un préréglage de chat configuré par l’administrateur et d’envoyer la clé vers une intégration cliente prise en charge.

Créer une clé API

1. Ouvrez « Clés API » et cliquez sur « Créer une clé API ».
2. Saisissez un nom de clé permettant de distinguer les applications ou les environnements.
3. Réglez le quota, l’expiration, les restrictions de modèles, les restrictions d’IP et le groupe selon vos besoins.
4. Après l’enregistrement, consultez et copiez la clé complète depuis la liste.

Options de configuration

Paramètre	Effet
Nom	Nom de la clé API (nommez-la selon son usage, par exemple « Production » ou « Test »)
Groupe	Le groupe de canaux utilisé par cette clé
Ordre de groupe Auto	Affiché uniquement si le groupe est auto. Conserve l’ordre par défaut, ou fixe l’ordre d’essai des groupes pour cette clé
Relance inter-groupes	Une fois activée, un groupe indisponible enchaîne sur le suivant. Meilleure disponibilité, mais les prix peuvent différer d’un groupe à l’autre
Expiration	La clé est refusée passé cette date
Quantité	Créer plusieurs clés API d’un coup (un suffixe aléatoire est ajouté au nom)
Quota	Plafonne le quota consommable par cette clé
Quota illimité	Une fois activé, donne un quota illimité à cette clé API
Restrictions de modèles	Limite la clé aux modèles indiqués. Vide signifie aucune restriction
Liste d’IP autorisées	Une IP ou un CIDR par ligne. Vide signifie aucune restriction. Idéal pour un serveur à IP publique fixe ; les connexions domestiques et mobiles changent souvent d’IP et vous bloqueront dehors

Danger

Une clé API équivaut à un mot de passe. Ne mettez jamais une clé complète dans un dépôt de code, une capture d’écran, un journal ou un outil de discussion. En cas de suspicion de fuite, supprimez-la immédiatement et créez-en une nouvelle.

Consulter et copier une clé API

Cliquez sur la clé masquée dans la liste et suivez les instructions pour afficher et copier la valeur complète. La clé complète est un identifiant sensible : son affichage peut demander une vérification de sécurité supplémentaire.

« Copier les informations de connexion » copie la clé et l’adresse de la plateforme au format d’import pour une application. En cliquant sur un préréglage de chat sous « Chat » dans la barre latérale, le navigateur tente de lancer l’application de chat installée et de remplir automatiquement la configuration. Voir Intégration des applications de chat.

Modifier une clé API

Repérez la clé dans la liste et cliquez sur « Modifier » à droite pour changer ses options de configuration (la valeur de la clé elle-même ne peut pas être modifiée).

Activer, désactiver et supprimer des clés API

Les actions de ligne permettent d’activer, de désactiver ou de supprimer une clé ; sélectionner plusieurs lignes permet une suppression en lot. La désactivation conserve la configuration et arrête les appels, tandis que la suppression est irréversible.

Attention

Une fois la suppression confirmée, la clé API cesse immédiatement de fonctionner et ne peut pas être récupérée. Vérifiez votre sélection avant de supprimer, pour ne pas retirer une clé de production par erreur.

Pages liées

• Utiliser l’API et le Playground : adresses des points de terminaison, authentification et liste des endpoints pour les appels effectués avec une clé.
• Portefeuille et abonnements : le solde du compte et le quota d’abonnement, qui se combinent au plafond de la clé pour déterminer le volume disponible.
• Journaux et tâches asynchrones : filtrer les appels et le détail de facturation par nom de clé.