Clés API

Les clés API authentifient les requêtes vers l'API Mistral et les autres outils Mistral. Dans Admin, les Organization Admins peuvent créer, consulter, renouveler et supprimer des clés API dans les Workspaces.

Les développeurs peuvent aussi créer et gérer leurs propres clés API depuis la fenêtre de profil utilisateur dans Studio. Les utilisateurs qui n'utilisent que Vibe n'ont généralement pas besoin de clés API, sauf s'ils utilisent aussi Studio, l'API, Vibe Code ou un autre outil de développement.

Les clés API peuvent être associées à plusieurs zones produit:

1. Ouvrez Admin Panel›API›API Keys ↗.
2. Sélectionnez Create new key.
3. Vous pouvez saisir un Key name.
4. Sélectionnez le Workspace auquel la clé appartient.
5. Définissez une date d'Expiration. Si une politique d'expiration des clés API s'applique au Workspace sélectionné, le sélecteur de date propose uniquement les dates autorisées et l'option sans expiration n'est pas disponible. Si aucune politique ne s'applique, choisissez une date future ou laissez la clé sans expiration.
6. Choisissez le Connector access scope.
7. Sélectionnez Create new key.
8. Copiez la clé immédiatement.

Après la création d'une clé, vous ne pouvez pas modifier son Workspace, son Connector access scope ou sa date d'expiration. Pour modifier ces paramètres, créez une nouvelle clé et supprimez l'ancienne.

Ouvrez Admin Panel›API›API Keys ↗ pour consulter les clés API dans l'Organization.

La liste des clés affiche:

• les clés actives et expirées;
• le type de clé;
• le Workspace;
• la date de dernière utilisation;
• la date d'expiration.

Depuis la liste, les admins peuvent:

• renouveler une clé en créant une nouvelle clé puis en supprimant l'ancienne;
• supprimer une clé;
• identifier les clés inutilisées ou expirées.

Une politique d'expiration des clés API définit la durée de validité maximale des nouvelles clés API. Les politiques sont désactivées par défaut. Les clés existantes, y compris les clés sans expiration, continuent de fonctionner jusqu'à leur révocation ou leur expiration initiale.

Les Organization Admins peuvent définir un maximum au niveau de l'Organization. Les Workspace Admins peuvent définir un maximum plus strict pour leur Workspace, mais ils ne peuvent pas dépasser le maximum de l'Organization. Les contrôles côté serveur appliquent les politiques actives pour les chemins de création API et interface utilisateur.

Pour comprendre le comportement et la hiérarchie de la politique, consultez Politique d'expiration des clés API.

Les admins et les développeurs peuvent gérer leurs propres clés API depuis la fenêtre de profil utilisateur:

• Dans Studio, ouvrez Studio›API keys ↗.
• Ou ouvrez le menu de votre profil utilisateur et sélectionnez API Keys.

Utilisez ce parcours pour les clés qui vous appartiennent. Utilisez le parcours Admin Panel lorsque vous devez gérer des clés dans toute l'Organization.

Les clés API sont limitées au Workspace dans lequel elles ont été créées. Les requêtes envoyées avec une clé utilisent le quota, les limites de débit et les ressources de ce Workspace.

Pour utiliser des clés différentes selon les environnements, par exemple développement, staging et production, créez des Workspaces séparés et créez une clé API dédiée dans chaque Workspace.

Le Connector access scope contrôle les Connectors de Workspace que la clé peut utiliser.

La portée par défaut est Shared connectors only. Utilisez-la pour les automatisations. Choisissez Private and shared connectors uniquement lorsque l'application doit accéder aux Connectors privés du créateur de la clé.

Pour l'administration des Connectors, consultez Connectors.