Limites et accès

Dans la console, Paramètres → Limites et accès (Settings → Limits & access) regroupe les budgets et les règles d’accès de toute l’équipe, pour éviter les dépassements imprévus et les abus en cas de fuite d’une clé API.

Règle	Rôle	Où la configurer
Limite de dépenses	Les appels s’arrêtent une fois la limite atteinte	Équipe, membres : Limites et accès ; clé : API Keys
Liste blanche d’IP	N’autorise que les serveurs indiqués	Équipe : Limites et accès ; clé : menu de la clé → IP Whitelist
Modèles autorisés	Limite les modèles appelables	Équipe : Limites et accès ; clé : menu de la clé → Allowed models
Débit de requêtes	Requêtes par minute partagées par toutes les clés de l’équipe	Lecture seule, voir Limites de débit

Seuls les propriétaires et administrateurs de l’équipe peuvent modifier ces règles. Chaque modification est consignée dans Historique des modifications (Change history), en haut à droite de la page.

Limite de dépenses

Les budgets se répartissent sur trois niveaux — équipe, membre, clé API — avec une période Quotidien (Daily), Mensuel (Monthly) ou Total.

Budget d’équipe : plafond de dépenses de toute l’équipe
Budget par défaut des membres (Default member budget) : calculé pour chaque membre séparément ; si un membre a son propre budget, c’est celui-ci qui s’applique
Budget de clé : défini pour une clé donnée sur la page API Keys

Les trois niveaux sont calculés indépendamment : dès que l’un d’eux est épuisé, la requête est bloquée. Sur une même période, le budget d’une clé ne peut pas dépasser celui de son membre, ni le budget d’un membre celui de l’équipe.

Chaque budget a un mode de traitement :

Mode	Quand la limite est atteinte
Notifier et bloquer (Notify and block)	Envoie un e-mail d’alerte et arrête les appels
Notifier uniquement (Notify only)	Envoie seulement un e-mail d’alerte, sans bloquer

Recharger le solde ne rétablit pas les appels une fois un budget épuisé. Il faut relever la limite ou attendre la réinitialisation de la période quotidienne / mensuelle.

Liste blanche d’IP

N’autorise que des adresses IPv4 ou plages CIDR précises, jusqu’à 100 entrées. Les requêtes provenant d’adresses hors liste sont refusées.

Liste blanche d’IP de l’équipe : s’applique à toutes les clés API de l’équipe
Liste blanche d’IP de la clé : restreint davantage la liste de l’équipe pour une clé donnée ; une adresse de la liste de la clé n’est prise en compte que si elle figure aussi dans la liste de l’équipe

Pratique pour verrouiller les clés de production sur vos propres serveurs : même en cas de fuite, la clé ne peut pas être utilisée ailleurs.

Modèles autorisés

L’équipe a le choix entre trois modes, avec sélection groupée par fournisseur :

Mode	Description
Tous les modèles (All models)	Tous les modèles sont appelables, y compris ceux publiés à l’avenir
Uniquement ces modèles (Only these models)	Seuls les modèles de la liste sont appelables ; les nouveaux modèles publiés à l’avenir ne le sont pas non plus
Bloquer ces modèles (Block these models)	Les modèles de la liste ne sont pas appelables, les autres ne sont pas concernés

Chaque clé peut aussi être restreinte davantage via Modèles autorisés (Allowed models) dans son menu. Les règles de l’équipe et de la clé s’appliquent ensemble : seul un modèle autorisé des deux côtés peut être appelé.

Vérifier les règles effectives

Une clé est soumise à deux niveaux de règles à la fois : ceux de l’équipe et ceux de la clé. Dans API Keys, ouvrez le menu de la clé, cliquez sur Vérifier les règles effectives (Check effective rules) et choisissez un modèle : vous voyez si l’appel serait bloqué, par quelle règle, et combien de budget il reste. La vérification ne consomme pas de crédits.

Réponse en cas de blocage

Une requête arrêtée par un budget ou une règle d’accès n’aboutira pas en réessayant ; il faut d’abord ajuster les règles :

Code de statut	Code d’erreur	Cause	Que faire
`402`	`spending_limit_exceeded`	Limite de dépenses de l’équipe, du membre ou de la clé dépassée	Relevez la limite ou attendez la réinitialisation de la période
`402`	`insufficient_credits`	Solde insuffisant	Rechargez
`403`	`ip_not_allowed`	L’IP appelante n’est pas dans la liste blanche	Ajoutez cette IP à la liste blanche de l’équipe ou de la clé
`403`	`model_not_allowed`	L’équipe ou la clé n’autorise pas ce modèle	Changez de modèle ou ajustez les modèles autorisés
`503`	`spending_limit_check_unavailable`	Vérification du budget momentanément impossible	Réessayez plus tard

Les requêtes bloquées apparaissent dans Activité (Activity) avec le filtre Bloquées (Blocked). La liste complète des codes d’erreur figure dans Gestion des erreurs.

Historique des modifications

Pour la liste blanche d’IP, les modèles autorisés et les budgets, vous pouvez retrouver qui a modifié quoi et quand dans Historique des modifications (Change history), en haut à droite de Limites et accès. Les réglages de conservation des journaux n’y sont pas consignés, voir Journaux de requêtes.