# Clés API

> Créer, cadrer et gérer les clés de l'API.

Source: https://reverie.im/fr/docs/integrations/api-keys
Language: fr

Une clé API authentifie les requêtes vers l'[API ouverte](https://reverie.im/fr/docs/integrations/open-api) de Reverie. Les clés se trouvent dans **Paramètres → Plus → Clés API**, là même où pointe la tuile **API ouverte** de Labs. N'importe quel compte peut en créer — aucune condition de palier, aucun plafond sur le nombre que vous détenez.

## Créer une clé \[#create-a-key]

### Appuyez sur Créer une nouvelle clé API \[#press-create-new-api-key]

Sur une page vide, le bouton indique **Créer votre première clé API**.

### Donnez-lui un nom \[#name-it]

Le **Nom** est obligatoire, de 1 à 100 caractères. C'est ainsi que la clé est étiquetée dans la liste et dans les statistiques d'utilisation — « Enceinte du salon », « staging worker ».

### Choisissez Global ou un personnage précis \[#choose-global-or-a-specific-character]

**Sélection du personnage** est un choix entre **Global (Tous les personnages)** et **Personnage spécifique**, pas une option facultative. Le personnage choisi devient le personnage épinglé de la clé.

### Éventuellement un type d'appareil et une expiration \[#optionally-set-a-device-type-and-an-expiry]

**Type d'appareil** est du texte libre (`speaker`, `phone`, `iot`). **Expiration** demande une date *et* une heure ; à cet instant précis, la clé cesse de fonctionner d'elle-même.

La clé apparaît immédiatement sous la forme `rk_` suivi de 64 caractères hexadécimaux.

## Les clés restent consultables \[#keys-stay-retrievable]

Le secret n'est pas révélé une seule fois. La carte de chaque clé propose **Afficher la clé API**, **Masquer la clé API** et **Copier la clé API**, à tout moment, tant que la clé existe.

> Puisque le secret complet reste lisible depuis vos paramètres, considérez l'accès au compte comme un accès à la clé. Gardez la clé sur un serveur ou dans un gestionnaire de secrets, jamais dans le contrôle de version ni dans du code de navigateur.

## Clés globales et clés épinglées \[#global-keys-and-pinned-keys]

|                              | **Global (Tous les personnages)**              | **Personnage spécifique**                                                 |
| ---------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------- |
| Ce que renvoie `GET /models` | Vos personnages récents                        | Les scénarios de ce personnage, ou le personnage lui-même s'il n'en a pas |
| `model` omis                 | Retombe sur votre conversation la plus récente | Utilise le personnage épinglé                                             |
| IDs courts de scénario       | Ne se résolvent jamais                         | Se résolvent sur le personnage épinglé                                    |

## Désactiver, supprimer, renouveler \[#disable-delete-rotate]

| Action            | Effet                                                                    | Réversible |
| ----------------- | ------------------------------------------------------------------------ | ---------- |
| Bascule **Actif** | Tant qu'elle est désactivée, les requêtes avec cette clé sont rejetées   | Oui        |
| **Supprimer**     | La clé est détruite et les applications qui s'en servent perdent l'accès | Non        |

Il n'existe pas d'action de révocation distincte — désactiver et supprimer sont les deux possibilités.

> Supprimer une clé est irréversible, et cela emporte son attribution : son trafic passé bascule dans un groupe **Clés supprimées** des statistiques d'utilisation, où vous ne pouvez plus dire quelle intégration a dépensé quoi. Désactivez d'abord la clé si l'historique peut vous servir.

Pour renouveler, créez la clé de remplacement, déployez-la, puis désactivez ou supprimez l'ancienne. Il n'y a ni renouvellement automatique ni délai de grâce après l'expiration — une clé expirée est rejetée avec `api_key_expired` à la requête suivante.

## Portées \[#scopes]

Les clés portent des portées, et la fenêtre de création ne les montre pas. Une clé créée dans les Paramètres peut appeler les endpoints de chat, et rien d'autre.

L'endpoint d'import de personnages exige une autre portée, et le seul moyen d'obtenir une telle clé est d'ouvrir **Labs → Compétence d'importation de personnages**, qui en crée une nommée **Reverie Character Importer (Skill)**. Appeler l'importateur avec une clé ordinaire des paramètres renvoie un 403. [Importer des personnages →](https://reverie.im/fr/docs/characters/import-characters)

## Statistiques d'utilisation \[#usage-statistics]

Le panneau **Statistiques d'utilisation** de la même page indique **Requêtes**, **Tokens**, **Crédits** et **Clés actives**, regroupés par jour UTC, avec un détail par clé sous **Utilisation par clé**. Filtrez sur une clé ou sur **Toutes les clés**, sur une fenêtre de 7 à 90 jours — 30 par défaut. Seules les conversations créées via l'API sont comptées.

Ce panneau est le seul endroit où la dépense par clé existe. Votre historique de crédits note ce qu'a coûté chaque message, mais il n'associe pas la transaction à la clé qui l'a provoquée : servez-vous donc de ces statistiques pour comparer vos intégrations.

## Créer une requête \[#build-a-request]

**Créer une requête** ouvre un générateur : choisissez une de vos clés actives, choisissez un personnage ou un scénario dans la liste visible par cette clé, tapez un message, réglez le streaming et la température, puis copiez du cURL, du TypeScript ou du Python qui marche.

La clé ne sert, dans votre navigateur, qu'à charger la liste des personnages. Le code généré lit `REVERIE_API_KEY` dans l'environnement plutôt que d'embarquer le secret.

## Limites \[#limits]

| Limite                          | Valeur                                                       |
| ------------------------------- | ------------------------------------------------------------ |
| Clés par compte                 | Aucune limite                                                |
| Limite de débit par clé         | Aucune                                                       |
| Plafond de concurrence par clé  | Aucun                                                        |
| Ce qui borne réellement l'usage | Votre solde de crédits, plus la fenêtre des modèles gratuits |

## Voir aussi \[#related]

* [API ouverte](https://reverie.im/fr/docs/integrations/open-api) — endpoints, forme des requêtes et erreurs
* [Importer des personnages](https://reverie.im/fr/docs/characters/import-characters) — à quoi sert la clé d'import
* [Reverie Labs](https://reverie.im/fr/docs/integrations/labs) — les tuiles API ouverte et import
* [Sécurité](https://reverie.im/fr/docs/account/security) — le reste des réglages d'accès de votre compte