Utilisez les alertes de dépenses pour suivre les coûts mensuels liés à l’API. Pour interrompre le trafic lorsque les dépenses enregistrées atteignent un montant donné, appliquez une limite stricte de dépenses à votre organisation ou à un projet en particulier.
Les limites strictes de dépenses peuvent interrompre le trafic en production. Lorsque les dépenses enregistrées atteignent une limite stricte applicable, l’API répond aux requêtes concernées par une erreur 429 avec le code organization_spend_limit_exceeded ou project_spend_limit_exceeded. La limite ne prend pas effet instantanément. Les dépenses enregistrées peuvent donc dépasser légèrement le montant fixé.
Choix du mode de contrôle des dépenses
Les alertes de dépenses et les limites strictes de dépenses ont des effets différents :
| Mode de contrôle | Lorsque les dépenses atteignent le montant fixé | Objectif |
|---|---|---|
| Alerte de dépenses | Une notification est envoyée et le trafic API se poursuit | Suivre les dépenses sans interrompre le trafic |
| Limite stricte de dépenses | L’API répond aux requêtes concernées par une erreur 429 |
Appliquer un plafond mensuel à l’organisation ou à un projet |
Les alertes de dépenses n’imposent aucun plafond. Elles restent actives lorsque vous ajoutez une limite stricte de dépenses. Vous pouvez ainsi recevoir une notification avant que la limite stricte n’interrompe le trafic.
OpenAI fixe également pour votre organisation une limite d’utilisation mensuelle en fonction de son niveau d’utilisation. Cette limite d’utilisation approuvée par OpenAI est distincte des limites de dépenses que vous configurez.
Configuration d’une limite de dépenses
Vous devez disposer des autorisations nécessaires pour gérer les paramètres de l’organisation ou du projet concerné. Pour en savoir plus, consultez les autorisations de la Plateforme API.
- Ouvrez la page Limites de l’organisation.
- Dans Dépenses, sélectionnez Modifier la limite de dépenses.
- Saisissez le montant de la Limite mensuelle de dépenses.
- Pour que l’API renvoie une erreur une fois la limite de l’organisation atteinte, activez Appliquer une limite stricte.
- Sélectionnez Enregistrer.
- Ouvrez la page Paramètres du projet.
- Sélectionnez Limites.
- Dans Dépenses, sélectionnez Modifier la limite de dépenses.
- Saisissez le montant de la Limite mensuelle de dépenses.
- Pour que l’API renvoie une erreur une fois la limite du projet atteinte, activez Appliquer une limite stricte.
- Sélectionnez Enregistrer.
Fonctionnement des limites strictes
Les limites strictes de l’organisation et du projet peuvent toutes deux s’appliquer à une même requête :
- La limite stricte de l’organisation s’applique au trafic API de tous ses projets.
- La limite stricte d’un projet s’applique uniquement au trafic API facturé à ce projet.
- Lorsque l’organisation atteint sa limite stricte, l’API renvoie une erreur
429avec le codeorganization_spend_limit_exceeded. - Lorsqu’un projet atteint sa limite stricte, l’API renvoie une erreur
429avec le codeproject_spend_limit_exceeded. - Si vous augmentez ou supprimez la limite atteinte, le trafic peut reprendre une fois la modification propagée. Sinon, la limite se réinitialise au début du cycle mensuel suivant.
La limite ne prend pas effet instantanément. Le temps que l’information se propage, la Plateforme API peut encore traiter un faible volume de trafic. Les dépenses enregistrées peuvent donc dépasser légèrement le montant fixé.
Alertes de dépenses
Utilisez les alertes de dépenses pour recevoir une notification avant que vos dépenses n’atteignent une limite stricte. Ajoutez des alertes à des seuils qui vous laissent le temps d’ajuster votre utilisation, d’augmenter la limite ou de rechercher la cause d’un trafic inattendu.
Rétablissement du trafic API
Si des requêtes échouent en raison d’une limite liée à la facturation ou d’un solde de crédits insuffisant :
- Vérifiez
error.codepour déterminer si l’échec est dû à une limite de dépenses de l’organisation ou du projet, à la limite d’utilisation fixée par OpenAI ou à l’épuisement des crédits prépayés de l’organisation. - Pour
organization_spend_limit_exceededouproject_spend_limit_exceeded, comparez votre utilisation actuelle à vos limites de dépenses. Si le trafic doit reprendre avant la réinitialisation mensuelle, augmentez ou supprimez la limite atteinte. - Pour
organization_usage_limit_exceeded, demandez une augmentation de votre limite d’utilisation approuvée. - Pour
credit_balance_exhausted, ajoutez des crédits. - Si l’erreur signale une limite de débit pour les requêtes ou les tokens, suivez les instructions du guide sur les limites de débit.