Clés API velqa.dev — créer, limiter et révoquer vos clés (paiement en dirhams)
Vos clés API sk-... authentifient chaque requête vers velqa.dev. Ce guide explique comment les créer depuis le tableau de bord, restreindre les modèles autorisés, poser des limites de budget en dollars, de RPM et de TPM, et révoquer une clé compromise.
Prérequis : vérifier votre email
Vous devez confirmer votre adresse email avant de pouvoir créer une clé. Si le bouton « Créer une clé » est verrouillé, ouvrez la vue d'ensemble et cliquez sur « Renvoyer l'email », puis suivez le lien reçu. Voir Comptes et connexion.
Créer une clé
- Ouvrez Clés API dans la barre latérale.
- Cliquez sur Créer une clé.
- Donnez-lui un nom (optionnel mais recommandé, par exemple « Cline perso ») pour la reconnaître plus tard.
- Validez avec Créer la clé.
La clé complète, qui commence par sk-, n'est affichée qu'une seule fois, à la création. Copiez-la immédiatement avec le bouton de copie et collez-la dans votre outil ou votre gestionnaire de secrets. Confirmez avec « J'ai copié ma clé » pour fermer la fenêtre.
Une fois la fenêtre fermée, la liste n'affiche plus qu'un aperçu masqué de la clé — impossible de la révéler à nouveau. Si vous l'avez perdue, créez-en une nouvelle et supprimez l'ancienne.
La liste des clés
Le tableau des clés affiche pour chacune :
- Nom
- Clé (aperçu masqué uniquement)
- Créée le
- Dernière utilisation (« Jamais utilisée » tant qu'aucune requête n'a été faite)
- Limites actives
- Actions (limites, suppression)
Une clé révoquée est marquée d'un badge Révoquée et ne peut plus servir.
Restreindre les modèles autorisés
Vous pouvez limiter une clé à un sous-ensemble de modèles — pratique pour cantonner une clé de prototype aux modèles économiques. Depuis la section Modèles, choisissez « Gérer les modèles activés pour la clé » et activez ou désactivez chaque modèle. Un modèle indisponible sur votre plan ne peut pas être activé. Voir la liste complète dans Modèles.
Poser des limites : Budget, RPM, TPM
Ouvrez l'action Limites d'une clé pour définir :
| Limite | Description |
|---|---|
| Budget (USD) | Un plafond de dépense en dollars pour la clé, avec une Période : *Total* (plafond unique cumulé) ou *Mensuel* (remis à zéro chaque mois). |
| Requêtes / min (RPM) | Nombre maximal de requêtes par minute pour la clé. |
| Tokens / min (TPM) | Nombre maximal de tokens par minute pour la clé. |
Chaque limite doit rester sous le plafond de votre plan : vous répartissez la capacité de votre plan entre vos clés, vous ne l'augmentez pas. Laissez un champ vide pour ne pas y toucher, et définissez au moins une limite pour enregistrer. Ces plafonds de plan sont détaillés dans Limites de débit.
Vous pouvez aussi fixer une Expiration pour qu'une clé cesse d'être valide à une date donnée.
Révoquer ou supprimer une clé
Utilisez l'action de suppression dans la ligne de la clé pour la révoquer. La révocation est immédiate : toute requête portant cette clé est rejetée. Faites-le dès qu'une clé fuite (commit public, journal partagé, poste perdu) puis créez-en une nouvelle.
En savoir plus
- Authentification — comment la clé est transmise dans vos requêtes.
- Limites de débit — les plafonds RPM / TPM par plan.