Management API Keys

Les Management API Keys gèrent les projets, les budgets et les clés API de modèle, et consultent l’utilisation des projets et des clés de toute l’équipe.

Les Management API Keys gèrent les projets, les budgets et les clés API de modèle, et consultent l’utilisation des projets et des clés de toute l’équipe.

Quelle clé utiliser ?

Ce tableau compare les clés API. Les jetons OAuth à portée limitée restent acceptés pour les requêtes de facturation lorsque cette fonction est activée.

Créer une clé de gestion

  1. Connectez-vous à la Console et sélectionnez une équipe dont vous êtes Owner.
  2. Ouvrez Developer → Management API Keys dans la barre latérale, ou accédez directement à la page. Cette entrée est réservée au propriétaire actuel de l’équipe.
  3. Renseignez Name, éventuellement Expires (optional), puis cliquez sur Create key.
  4. Cliquez sur Copy key et conservez la nouvelle clé mgmt-... dans ATLASCLOUD_MANAGEMENT_API_KEY pour les exemples. Le secret n’est affiché qu’une fois.

Où trouver api_key_id ?

api_key_id dans l’URL correspond au champ id, au format ak_..., renvoyé par Créer une clé API de modèle (POST /public/v1/api-keys). Conservez-le pour désactiver ou supprimer la clé, définir son plafond et consulter son utilisation. Le champ key (apikey-...) sert aux appels de modèles ; les appels de gestion utilisent toujours mgmt-... dans l’en-tête d’autorisation.

La réponse de création contient par exemple ces champs :

{
  "id": "ak_0123456789ABCDEFGHIJKL",
  "key": "apikey-REPLACE_WITH_SECRET_RETURNED_ONCE"
}

Insérez ce même id dans le chemin, par exemple /public/v1/api-keys/ak_0123456789ABCDEFGHIJKL/usage. API_KEY_ID désigne cette valeur dans les exemples. La Public API ne propose actuellement pas de liste des clés ; conservez donc id lors de la création.

Appeler la Public API

Envoyez la clé de gestion dans l’en-tête Authorization: Bearer. Les requêtes utilisent le compte Team associé à cette clé.

curl -X POST "https://api.atlascloud.ai/public/v1/projects" \
  -H "Authorization: Bearer $ATLASCLOUD_MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"customer-123"}'

Guide de création pas à pas (anglais).

Gérer la clé

Les clés de gestion désactivées, supprimées ou expirées ne permettent pas de s’authentifier. La page de gestion permet d’activer ou de désactiver les clés non expirées. La suppression est définitive.

Les clés appartiennent à l’équipe et restent valides lorsque leur créateur quitte l’équipe ou n’en est plus Owner. Le propriétaire actuel peut gérer les clés des anciens propriétaires. Désactivez ou supprimez une clé pour révoquer son accès.

Chaque équipe peut conserver 5 clés de gestion non supprimées au maximum, y compris les clés désactivées et expirées. Supprimer une clé libère une place.

Last updated on

On this page