---
title: Clés API
description: Générez, copiez, identifiez et révoquez une clé API Runner personnelle en toute sécurité.
---

Les clés API sont des secrets personnels pour l'accès programmatique à Runner. Créez-en une uniquement pour une application de confiance, stockez-la de manière sécurisée et révoquez-la lorsqu'elle n'est plus nécessaire.

## Ce que couvre ce guide

Vous saurez comment créer et enregistrer le secret unique, identifier les clés existantes sans les exposer et révoquer une clé avec confirmation.

## Disponibilité et conditions préalables

- **Clés API** est conditionnelle et n'apparaît que si elle est activée pour votre compte.
- Les clés appartiennent à votre compte personnel, pas à un magasin.
- Ne mettez jamais une clé complète dans un chat, une mémoire d'agent, une compétence, une capture d'écran, un contrôle de source ou une documentation produit.

## Chemin d'accès

Sélectionnez **avatar → Paramètres → Personnel → Clés API**. Si l'entrée est absente, la fonctionnalité n'est pas disponible pour le compte actuel.

## Contrôles

| Entrée ou bouton | Pourquoi c'est utile | Ce qui se passe ensuite |
| --- | --- | --- |
| **Générer une nouvelle clé** | Créez une nouvelle identifiant. | Une boîte de dialogue s'ouvre avec un champ Nom facultatif. |
| **Nom** | Identifiez l'application plus tard sans exposer le secret. | Le nom apparaît dans le tableau des clés ; vide crée une clé sans titre. |
| **Créer une clé** | Générez l'identifiant. | Runner ouvre **Clé API générée** et affiche le secret complet une seule fois. |
| Icône d'œil | Vérifiez la valeur nouvellement générée complète avant de la stocker. | La valeur unique est affichée ou masquée dans la boîte de dialogue de succès. |
| Icône de copie | Copiez la nouvelle clé avec précision. | Runner la copie dans le presse-papiers et affiche une confirmation. |
| **Je l'ai enregistré** | Fermez la vue du secret unique. | La valeur complète est effacée de la boîte de dialogue et ne peut pas être affichée à nouveau là. |
| Tableau des clés existantes | Identifiez les clés en toute sécurité. | Runner affiche Nom, Préfixe, Créé et Dernière utilisation, pas le secret complet. |
| Icône de suppression | Révoquez une clé existante. | Une confirmation explique que la révocation ne peut pas être annulée. |
| **Révoquer** | Désactivez la clé sélectionnée. | Après succès, la clé est supprimée de la liste et ne peut plus s'authentifier. |

## Générer et stocker une clé

1. Ouvrez **Personnel → Clés API**.
2. Sélectionnez **Générer une nouvelle clé**.
3. Entrez un nom descriptif, tel que l'application ou l'environnement. Ne mettez pas de secret dans le nom.
4. Sélectionnez **Créer une clé**.
5. Dans **Clé API générée**, révélez la clé uniquement si nécessaire et sélectionnez Copier.
6. Stockez-la dans un gestionnaire de secrets de confiance.
7. Confirmez la valeur stockée avant de sélectionner **Je l'ai enregistré**.
8. Utilisez le préfixe du tableau pour identifier la clé plus tard sans exposer la valeur complète.

Runner avertit que la clé complète ne sera pas affichée à nouveau. Si vous fermez la boîte de dialogue sans l'enregistrer, révoquez cette clé et créez un remplacement plutôt que d'essayer de récupérer le secret.

## Révoquer une clé

1. Faites correspondre la clé prévue par Nom et Préfixe.
2. Sélectionnez son icône de suppression.
3. Vérifiez la confirmation **Révoquer**.
4. Sélectionnez **Révoquer** uniquement lorsque l'application dépendante est prête à arrêter de l'utiliser.
5. Confirmez **Clé API révoquée** et supprimez l'ancien secret de l'application.

La révocation est destructive et ne peut pas être annulée. Créez une nouvelle clé si l'accès est nécessaire à nouveau.

## États et limites

- **Aucune clé API pour le moment** est l'état vide normal.
- La valeur complète d'une nouvelle clé n'apparaît que dans sa boîte de dialogue de succès.
- Les lignes existantes affichent un préfixe et les dates d'utilisation, pas une clé récupérable.
- **Jamais** sous Dernière utilisation signifie que Runner n'a pas enregistré de demande pour cette clé.
- Les boutons Créer et Révoquer affichent la progression et ne doivent pas être soumis à plusieurs reprises.

## Dépannage

- Si les clés API sont manquantes, n'utilisez pas un lien direct copié ; la fonctionnalité est désactivée pour ce compte.
- Si la copie du presse-papiers échoue, révélez la nouvelle valeur et copiez-la manuellement dans un gestionnaire de secrets sécurisé, puis masquez-la à nouveau.
- Si vous avez perdu une clé complète, révoquez sa ligne et générez un remplacement.
- Si une application cesse de fonctionner après la révocation, mettez-la à jour avec une clé nouvellement créée ; l'ancienne clé ne peut pas être restaurée.
- Si la mauvaise clé a été sélectionnée, annulez la confirmation et comparez à nouveau Nom et Préfixe.

## Guides connexes

- [Sécurité et sessions](./security-and-sessions)
- [Paramètres personnels et espaces de travail](./personal-settings-and-workspaces)
- [Sécurité de la mémoire](../agent/memory)