Utilisez les alertes de dépenses pour suivre les coûts mensuels liés à l’API. Pour interrompre le trafic lorsque les dépenses comptabilisées atteignent un montant défini, appliquez une limite stricte de dépenses à votre organisation ou à un projet particulier.
Les limites strictes de dépenses peuvent interrompre le trafic en production. Lorsque les dépenses comptabilisées atteignent
une limite stricte applicable, les requêtes API concernées renvoient une erreur 429 avec le code
organization_spend_limit_exceeded ou project_spend_limit_exceeded.
L’application de la limite n’est pas instantanée : les dépenses enregistrées peuvent donc légèrement dépasser
le montant défini.
Choisissez un dispositif de contrôle des dépenses
Les alertes de dépenses et les limites strictes de dépenses ont des effets différents :
| Dispositif | Effet lorsque le montant défini est atteint | À utiliser pour |
|---|---|---|
| Alerte de dépenses | Envoie une notification ; le trafic API se poursuit | Suivre les dépenses sans interrompre le trafic |
| Limite stricte de dépenses | Les requêtes API concernées renvoient une erreur 429 | Appliquer un plafond mensuel à une organisation ou à un projet |
Les alertes de dépenses n’imposent pas de plafond. Elles restent actives lorsque vous ajoutez une limite stricte de dépenses. Vous pouvez donc les utiliser pour recevoir une notification avant qu’une limite stricte n’interrompe le trafic.
OpenAI attribue également à votre organisation une limite d’utilisation mensuelle approuvée 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.
Configurez une limite de dépenses
Vous devez disposer de l’autorisation de gérer les paramètres de l’organisation ou du projet concerné. Pour en savoir plus, consultez les autorisations de la Plateforme API.
- Accédez aux limites de l’organisation.
- Dans Dépenses, sélectionnez Modifier la limite de dépenses.
- Saisissez la Limite mensuelle de dépenses.
- Pour que l’API renvoie des erreurs une fois que l’organisation a atteint la limite, activez Appliquer une limite stricte.
- Sélectionnez Enregistrer.
- Accédez aux paramètres du projet.
- Sélectionnez Limites.
- Dans Dépenses, sélectionnez Modifier la limite de dépenses.
- Saisissez la Limite mensuelle de dépenses.
- Pour que l’API renvoie des erreurs une fois que le projet a atteint la limite, activez Appliquer une limite stricte.
- Sélectionnez Enregistrer.
Comprenez le fonctionnement des limites strictes
Les limites strictes de l’organisation et du projet peuvent toutes deux s’appliquer à une même requête :
- Une limite stricte d’organisation s’applique au trafic API de tous les projets de l’organisation.
- Une limite stricte de projet s’applique uniquement au trafic API facturé à ce projet.
- Lorsqu’une limite stricte d’organisation est atteinte, une erreur
429est renvoyée avec le codeorganization_spend_limit_exceeded. - Lorsqu’une limite stricte de projet est atteinte, une erreur
429est renvoyée avec le codeproject_spend_limit_exceeded. - Augmenter ou supprimer la limite atteinte permet au trafic de reprendre une fois la mise à jour propagée. Sinon, la limite est réinitialisée au prochain cycle mensuel.
L’application de la limite n’est pas instantanée. La Plateforme API peut traiter un faible volume d’utilisation supplémentaire pendant la propagation de l’état de la limite. Les dépenses enregistrées peuvent donc légèrement dépasser le montant défini.
Alertes de dépenses
Utilisez les alertes de dépenses pour recevoir une notification avant que les dépenses n’atteignent une limite stricte. Définissez des seuils d’alerte qui vous laissent le temps d’ajuster l’utilisation, d’augmenter la limite ou d’examiner un trafic inattendu.
Rétablissez le trafic API
Si les requêtes échouent en raison d’une limite liée à la facturation ou du solde de crédits :
- Vérifiez
error.codepour déterminer si la requête a atteint une limite de dépenses de l’organisation, une limite de dépenses du projet ou une limite d’utilisation attribuée par OpenAI, ou si l’organisation a épuisé ses crédits prépayés. - Pour
organization_spend_limit_exceededouproject_spend_limit_exceeded, comparez l’utilisation actuelle à vos limites de dépenses. Augmentez ou supprimez la limite atteinte si le trafic doit reprendre avant la réinitialisation mensuelle. - Pour
organization_usage_limit_exceeded, demandez une limite d’utilisation approuvée plus élevée. - Pour
credit_balance_exhausted, ajoutez des crédits. - Si l’erreur indique une limite de débit de requêtes ou de tokens, suivez le guide sur les limites de débit.