Sécurité des clés API d’IA et maîtrise des coûts
Protégez vos charges d’IA : clés séparées, quotas, expiration, limites de modèles, listes d’IP autorisées, routage, rotation et attribution vérifiable des coûts.

Une clé API d’IA doit correspondre à une charge de travail précise, et non à toute une organisation pour une durée indéfinie. Des clés distinctes facilitent le contrôle de l’accès, du quota, du routage, de la rotation et des enregistrements d’utilisation, sans exposer un même identifiant à des applications sans rapport entre elles.
Les clés API Modelflare peuvent combiner une date d’expiration, un quota fini ou illimité, des limites de modèles, une liste d’IP autorisées et une politique de routage. Ces contrôles sont plus efficaces lorsqu’ils sont conçus ensemble, plutôt qu’ajoutés après un incident.
Commencer par une clé par charge de travail
Créez des clés distinctes pour les périmètres qui nécessitent un accès ou une comptabilité indépendants, par exemple :
- l’API de production et les workers en arrière-plan ;
- le développement et la CI ;
- un agent de code ou un outil local ;
- une application destinée aux clients ;
- un prestataire temporaire ou une migration ;
- une charge de travail par lot coûteuse.
Utilisez des noms qui décrivent l’environnement et l’objectif, comme prod-support-agent ou dev-evaluation. Un nom clair rend les enregistrements de requêtes et les décisions de rotation compréhensibles sans révéler le secret.
Garder le secret hors du code visible côté client
Stockez la clé complète dans un gestionnaire de secrets côté serveur ou dans une variable d’environnement protégée. Ne la placez pas dans :
- du JavaScript exécuté dans le navigateur ou des paquets mobiles que les utilisateurs peuvent inspecter ;
- le gestionnaire de versions, les images de conteneur, les captures d’écran ou les tickets ;
- les événements d’analyse, les outils de suivi des erreurs, l’historique du shell ou les journaux de l’application ;
- des URL, des chaînes de requête ou des exemples de commandes copiés avec des valeurs réelles.
Pour une application web, faites transiter les requêtes par un backend qui authentifie l’utilisateur et détient la clé Modelflare. Si une clé a pu fuiter, créez une clé de remplacement, basculez la charge de travail, vérifiez le trafic sur la nouvelle clé, puis révoquez l’ancienne.
Utiliser le quota et l’expiration comme des limites indépendantes
Un quota fini impose une limite d’utilisation stricte à la clé. Une date d’expiration limite la durée de validité de l’identifiant. Ils répondent à des risques différents :
| Contrôle | Objectif principal |
|---|---|
| Quota fini | Limite le volume d’utilisation attribuable à la clé |
| Quota illimité | Évite un plafond au niveau de la clé ; les crédits du compte et les autres politiques continuent de s’appliquer |
| Expiration | Met fin à l’accès après une durée définie |
| Désactivation ou révocation | Bloque immédiatement tout nouvel accès |
Les clés de développement, de prestataires et d’évaluation devraient généralement avoir à la fois un quota fini et une date d’expiration. Les clés de production peuvent nécessiter un quota plus élevé ou illimité, mais elles gagnent tout de même à bénéficier d’une attribution distincte par charge de travail et d’un plan de rotation.
Le quota ne remplace ni les limites de requêtes simultanées ni le contrôle des nouvelles tentatives côté client. Une rafale peut consommer rapidement le montant restant, et des échecs répétés peuvent générer des requêtes supplémentaires.
Restreindre les modèles lorsque la charge de travail est ciblée
Les limites de modèles empêchent une clé de demander des modèles hors de l’ensemble prévu. Elles réduisent le risque d’utiliser par erreur un modèle incompatible ou étonnamment coûteux, et fournissent une limite 403 plus claire lorsque le client demande un modèle auquel il ne devrait pas accéder.
Maintenez l’ensemble autorisé en cohérence avec l’endpoint. Une clé qui peut lister un modèle a toujours besoin d’un client et d’un protocole qui prennent en charge le format de requête de ce modèle. Consultez le contrat en vigueur dans Modèles et tarifs au lieu de recopier des ID de modèle dans un document de politique censé durer.
N’ajouter des règles IP que si le chemin réseau est stable
Une liste d’IP autorisées compare l’adresse IP du client observée par Modelflare aux adresses individuelles ou aux plages CIDR configurées sur la clé. Elle est utile pour les serveurs dont la sortie réseau est connue, mais elle peut bloquer le trafic lorsque :
- une charge de travail dans le cloud change d’adresses NAT sortantes ;
- les requêtes passent par un nouveau proxy ou une nouvelle passerelle ;
- les chemins IPv4 et IPv6 diffèrent ;
- un développeur change de réseau ;
- la plage CIDR configurée est plus large ou plus étroite que prévu.
Vérifiez le chemin de sortie réel avant d’activer la restriction, prévoyez une procédure de rotation d’urgence et ne considérez pas la liste d’IP autorisées comme un substitut à la protection du secret.
Choisir délibérément le routage classique ou intelligent
| Type de clé | Comportement de routage | Adapté à |
|---|---|---|
| Clé API classique | Un groupe principal explicite et, en option, des groupes de repli ordonnés | Charges de travail qui exigent un ordre de routes et une politique de groupe connus |
| Clé API intelligente (Smart API Key) | Évalue les groupes éligibles du compte selon une stratégie équilibrée, axée sur la stabilité ou sur le prix le plus bas | Charges de travail qui recherchent une sélection automatique des routes plus large |
Les deux types de clés envoient toujours le modèle et le protocole demandés. La politique de routage choisit un groupe éligible ; elle ne garantit pas que chaque groupe prend en charge chaque modèle ou chaque fonctionnalité. Une liste de repli classique doit être testée dans l’ordre. Une clé API intelligente doit être évaluée au regard des exigences réelles de latence, de prix et de compatibilité avant la mise en production.
Pour le détail du comportement, lisez Routage fiable des API d’IA.
Effectuer une rotation sans interruption évitable
Procédez à une rotation avec chevauchement :
- Créez une nouvelle clé avec les mêmes restrictions prévues.
- Enregistrez-la dans le système de gestion des secrets de l’application.
- Déployez le nouvel identifiant sans supprimer l’ancien.
- Vérifiez l’accès au modèle et une requête réelle.
- Confirmez que de nouveaux enregistrements d’utilisation apparaissent sous la nouvelle clé.
- Retirez l’ancienne clé de chaque déploiement et de chaque tâche d’automatisation.
- Désactivez ou supprimez l’ancienne clé.
- Surveillez les requêtes inattendues qui utilisent l’identifiant retiré.
Si la compromission est en cours, révoquez d’abord la clé et acceptez une interruption maîtrisée. La procédure avec chevauchement s’applique aux rotations planifiées, pas à une exposition qui se poursuit.
Relier la politique des clés à l’analyse des coûts
L’isolement au niveau de la clé rend l’analyse des coûts exploitable. Filtrez les journaux d’utilisation par clé, puis comparez le modèle, le groupe, l’utilisation en entrée et en sortie, le statut, les nouvelles tentatives et le coût. Un quota fini peut bloquer toute utilisation supplémentaire, mais ce sont les enregistrements de requêtes qui expliquent ce qui l’a consommé.
Consultez Suivi des coûts des API d’IA pour un processus de contrôle reproductible.
Liste de contrôle des clés API
- Une clé par application, environnement ou charge de travail dont quelqu’un est responsable.
- Aucun secret dans le code du navigateur, les dépôts, les journaux, les URL ou les captures d’écran.
- Un quota fini et une date d’expiration pour les utilisations temporaires ou expérimentales.
- Des restrictions de modèles pour les charges de travail ciblées.
- Des règles IP uniquement pour une sortie réseau vérifiée et stable.
- Un ordre de repli classique explicite ou une stratégie intelligente choisie délibérément.
- Une rotation testée avant la suppression de l’ancienne clé.
- Une analyse de l’utilisation et des coûts par clé après chaque changement de politique.
Questions fréquentes
Une clé illimitée supprime-t-elle toutes les limites de dépense ?
Non. Elle supprime le plafond de quota au niveau de la clé. Les crédits du compte, la tarification des modèles, la politique des groupes, les limites de requêtes et les autres contrôles du service continuent de s’appliquer.
Plusieurs clés permettent-elles de contourner une limite de débit ?
Pas nécessairement. Une limite peut s’appliquer au niveau du compte, du groupe de modèles ou de la route. Créez des clés pour gérer l’accès et l’attribution, pas comme moyen non vérifié de contourner une limite de débit.
Une liste d’IP autorisées suffit-elle si une clé fuite ?
Non. Les règles réseau limitent les endroits où une clé peut être utilisée, mais les chemins réseau changent et la configuration peut être erronée. Effectuez une rotation des identifiants exposés et protégez le secret au repos comme lors du déploiement.