Clés API
Créer, cadrer et gérer les clés de l'API.
Une clé API authentifie les requêtes vers l'API ouverte 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é
Appuyez sur Créer une nouvelle clé API
Sur une page vide, le bouton indique Créer votre première clé API.
Donnez-lui un nom
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
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
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
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 (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
| 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
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 →
Statistiques d'utilisation
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
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
| 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
- API ouverte — endpoints, forme des requêtes et erreurs
- Importer des personnages — à quoi sert la clé d'import
- Reverie Labs — les tuiles API ouverte et import
- Sécurité — le reste des réglages d'accès de votre compte