Skip to main content
Créez une clé dans le tableau de bord, stockez-la sur votre serveur et envoyez-la comme jeton Bearer dans les requêtes Gateway.

Types de clés

  • Clés API Gateway : appellent les endpoints de modèles, de fournisseurs et de génération accessibles dans votre espace de travail.
  • Clés API de gestion : appellent les API d’administration. Consultez Clés API de gestion.
Faites tourner une clé en mettant votre application à jour pour utiliser sa remplaçante avant d’invalider l’ancien identifiant. Consultez le point d’accès de rotation des clés. Les clés suivent le format phaseo_v1_sk_<kid>_<secret>. Traitez-les comme des mots de passe et évitez de les stocker dans du code côté client ou des dépôts publics.
Vous pouvez appeler des modèles :free sans déposer de crédits. Les modèles payants nécessitent un solde disponible dans le portefeuille.

Format de l’en-tête

Ajoutez la clé à l’en-tête Authorization de chaque requête :
La plupart des clients HTTP permettent de le configurer une seule fois. Par exemple, avec fetch :

Liste de contrôle pour gérer les clés


Erreurs d’authentification courantes

  • 401 Non autorisé : la clé est absente, invalide ou associée à un espace de travail désactivé.
  • 403 Interdit : la clé existe, mais ne peut pas accéder au fournisseur ou au modèle demandé.
  • 429 Too Many Requests : la clé ou l’espace de travail a dépassé une limite. Consultez les Limites de requêtes.
  • Erreurs 5xx : réessayez avec un délai exponentiel et contactez l’assistance si le problème persiste.
Dernière modification le 2 octobre 2026