---
title: "Créer et gérer des clés API"
description: "Créer, limiter, suivre et révoquer des clés API — et les garder en sécurité."
url: https://help.samsa.ai/fr/articles/143-creer-et-gerer-des-cles-api
collection: "API & MCP"
updated: 2026-07-07
language: fr
alternates: [en, de, it]
---

# Créer et gérer des clés API

Créer, limiter, suivre et révoquer des clés API — et les garder en sécurité.

## Créer et gérer des clés API

Une **clé API** est ce qui permet à un outil, un script ou un assistant IA d'agir au nom de ton organisation. Les clés sont créées et gérées dans Samsa par les propriétaires et les admins.

### Où trouver les clés API

Ouvre **Paramètres de l'organisation** > **Clés API**. Seuls les **propriétaires et admins de l'organisation** peuvent gérer les clés — si tu ne vois pas l'onglet, demande un accès à un admin.

### Créer une clé

1.  Va dans **Paramètres de l'organisation** > **Clés API** et clique sur **Créer une clé API**.
    
2.  Donne à la clé un **nom** que tu reconnaîtras plus tard — par exemple « pipeline CI » ou « Zapier ».
    
3.  Choisis les **scopes** (permissions) que la clé doit avoir — ne prends que ce dont elle a besoin (voir ci-dessous).
    
4.  Définis quand la clé **expire** — 30 jours, 90 jours, 1 an, Jamais, ou une date personnalisée.
    
5.  Clique sur **Créer la clé**.
    

**Copie ta clé tout de suite.** Samsa affiche la clé complète **une seule fois**, dans une fenêtre intitulée « Ta nouvelle clé API ». Pour des raisons de sécurité, seul un hachage est conservé — si tu perds la clé, tu ne peux pas la récupérer et tu devras en créer une nouvelle. Colle-la directement dans ton outil ou un gestionnaire de secrets sécurisé, puis confirme « J'ai enregistré la clé en lieu sûr ».

Chaque clé commence par `samsa_sk_`, ce qui la rend facile à reconnaître.

### Scopes (permissions)

Les scopes limitent chaque clé exactement à ce dont elle a besoin. Samsa propose :

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Scope</p></th><th colspan="1" rowspan="1"><p>Ce qu'il permet</p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Générer des images</strong></p></td><td colspan="1" rowspan="1"><p>Créer de nouvelles images et vérifier leur état</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Modifier des images</strong></p></td><td colspan="1" rowspan="1"><p>Modifier des images existantes et vérifier l'état des modifications</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Générer des vidéos</strong></p></td><td colspan="1" rowspan="1"><p>Créer de nouvelles vidéos et vérifier leur état</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Lire les modèles</strong></p></td><td colspan="1" rowspan="1"><p>Lister et consulter les modèles de ton organisation</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Gérer les modèles</strong></p></td><td colspan="1" rowspan="1"><p>Créer, mettre à jour et supprimer des modèles</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Lire l'utilisation</strong></p></td><td colspan="1" rowspan="1"><p>Lire le solde de crédits et les données d'utilisation</p></td></tr></tbody></table>

Une clé a besoin d'au moins un scope. Donne à chaque clé le **moins de scopes** possible pour sa tâche — une clé qui ne fait que générer des images n'a pas besoin d'accéder à la gestion des modèles.

### Suivre l'utilisation d'une clé

Le tableau des clés API affiche pour chaque clé le **statut** (Active, Expirée ou Révoquée), qui l'a créée, quand elle expire, quand elle a été **utilisée pour la dernière fois**, combien de **requêtes** elle a faites et les **crédits utilisés** (cette période, les 30 derniers jours ou depuis le début). Ouvre une clé pour voir une répartition des crédits par type d'action. Active **Afficher les clés révoquées** pour inclure les anciennes.

### Modifier et révoquer

-   **Modifier la clé** te permet de renommer une clé ou d'ajuster ses scopes et son expiration.
    
-   **Révoquer la clé** la désactive. Les intégrations qui utilisent cette clé **cessent de fonctionner immédiatement**, et la révocation est irréversible — révoque donc une clé dès qu'elle n'est plus nécessaire ou qu'elle a pu être exposée.
    

### Garder les clés en sécurité

-   **Traite une clé comme un mot de passe.** Ne la colle jamais dans du code public, des captures d'écran ou des chats partagés.
    
-   **Stocke-la dans un gestionnaire de secrets**, pas dans de simples fichiers.
    
-   **Utilise le minimum de scopes** et une **date d'expiration** plutôt que « Jamais » quand tu peux.
    
-   **Révoque les clés inutilisées** et fais tourner les clés régulièrement — crée-en une nouvelle, bascule ton outil dessus, puis révoque l'ancienne.
    
-   Si une clé est un jour exposée, **révoque-la immédiatement** et crée une remplaçante.
    

Il te faut les détails techniques pour utiliser une clé dans les requêtes ? Consulte le [guide d'authentification](https://docs.samsa.ai/guides/authentication) dans la documentation développeur (s'ouvre dans un nouvel onglet).
