Maîtrise des coûts du codage par IA avec limites de dépenses strictes
Suivez le coût de chaque session IA et étape d'agent, fixez des limites souples et strictes par espace de travail et par workflow, choisissez un niveau de modèles ou apportez votre clé de fournisseur.
Dans AI CodeOps, la maîtrise des coûts mesure chaque appel au modèle effectué par une session IA, affiche le coût par session et par étape d'agent, et arrête les dépenses aux limites que vous fixez pour l'espace de travail et pour chaque workflow. Vous choisissez aussi le niveau de prix des modèles, session par session, ou vous apportez votre propre clé de fournisseur.
Les agents de codage IA dépensent de l'argent à chaque appel au modèle. Sans limites, une longue session ou une planification mal configurée peut consommer le budget d'un mois en un après-midi. AI CodeOps enregistre le coût pendant qu'une session s'exécute, et pas seulement à la fin, de sorte qu'une limite peut arrêter une session en cours de route.
Quels agents interviennent
Chaque étape d'agent est un appel au modèle, donc chaque agent coûte quelque chose. Ce qui fait varier la facture, c'est le niveau sur lequel chaque étape s'exécute. Avec le niveau Auto, AI CodeOps choisit le niveau à chaque appel, selon ce à quoi sert l'appel :
| Appel | Agents | Ordre des niveaux |
|---|---|---|
| Pilotage | Architect, Reviewer, Security Auditor, ADR Writer, Product Analyst, Project Planner, Researcher | Premium, Standard, Economy |
| Écriture du changement | La passe de code après l'étape d'implémentation | Standard, Premium, Economy |
| Rédaction | Builder, Tester, les agents Engineer et tous les autres agents | Economy, Standard, Premium |
Chaque appel prend le premier niveau de son ordre qui est inclus dans votre offre et pour lequel il reste du quota. La revue des constats sur le diff compte comme du pilotage. Consultez le catalogue des agents pour savoir ce que fait chaque agent, et modèles pour les niveaux.
Un espace de travail peut aussi attribuer un autre modèle à un agent dans ses propres réglages d'agents. Le coût de cette étape est alors calculé au prix du modèle réellement utilisé.
Coût par session
Chaque appel au modèle est mesuré au moment où il a lieu. Les appels qui échouent en cours de route sont comptés eux aussi, car le fournisseur les facture quand même. Vous voyez le coût à plusieurs endroits :
- AI Sessions liste chaque session avec son statut, son coût et ses tokens.
- La page d'une session affiche le total, ainsi que le coût et les tokens de chaque étape d'agent.
- Changes indique ce que chaque changement a coûté à produire.
- Usage (sous Measure) trace le coût par jour sur le mois, filtrable par modèle et par clé API, avec un tableau des appels individuels.
Les coûts sont calculés à partir des prix publics de chaque fournisseur, ou des prix que vous définissez sur votre propre connexion fournisseur. Le dossier de preuves de chaque changement consigne aussi les tokens et le coût de chaque exécution.
Budgets par espace de travail et par workflow
Les rôles Owner, Admin et Billing Admin définissent un budget de coûts pour l'espace de travail sous Configure, Billing. Il comporte une période (quotidienne, hebdomadaire, mensuelle ou 30 jours glissants, en UTC), une limite souple, une limite stricte et des plafonds facultatifs par workflow. Les montants sont stockés en millionièmes de dollar américain. Voici la forme que la console enregistre via PUT /api/budget, pour un plafond mensuel de 500 $ avec un avertissement à 400 $ et un plafond de 50 $ sur un workflow :
{
"enabled": true,
"period": "monthly",
"softLimitMicros": 400000000,
"hardLimitMicros": 500000000,
"perWorkflowLimits": { "feature-sdlc": 50000000 },
"expectedVersion": 3
}
expectedVersion empêche deux personnes d'écraser mutuellement leurs modifications. Une fois que les dépenses de la période dépassent la limite stricte, une nouvelle session est refusée avec un verdict comme celui-ci :
{
"allowed": false,
"state": "denied",
"summary": "Dispatch denied: budget exceeded",
"reasons": ["over_workspace_cap"],
"currentSpendMicros": 501830000,
"softLimitMicros": 400000000,
"hardLimitMicros": 500000000,
"perWorkflowLimitMicros": null,
"estimatedCostUsdMicros": 0,
"periodStartedAt": "2026-10-01T00:00:00.000Z",
"period": "monthly"
}
Les dépenses sont recalculées à chaque fois à partir des sessions elles-mêmes, elles ne peuvent donc pas s'écarter de ce qui s'est réellement exécuté.
Barrières qualité concernées
Le budget est une barrière sur les dépenses, vérifiée à trois moments :
- Au lancement. Une fois que les dépenses de la période dépassent la limite stricte, ou que les dépenses d'un workflow dépassent son plafond, les nouvelles sessions sont refusées. Si la vérification elle-même échoue, la session ne démarre pas.
- Avant chaque appel au modèle. Une session en cours qui a franchi la limite stricte s'arrête avant son prochain appel, avec le motif sur sa page.
- Limite souple. Les sessions s'exécutent toujours, et chaque avertissement est enregistré avec les décisions de politique de l'espace de travail, à côté de chaque refus.
Si le budget arrête une session après l'écriture de son code mais avant la revue des constats, la revue est enregistrée comme non terminée, et la barrière qualité retient le changement. Un espace de travail sans budget n'a pas d'autre limite de dépenses que son quota de modèles.
Niveaux de modèles et quotas
Les sessions sur les modèles de la plateforme s'exécutent sur Economy (le niveau par défaut, dans toutes les offres), Standard (des modèles de milieu de gamme comme Kimi ou GLM), Premium (des modèles haut de gamme comme Claude) ou Auto, proposé lorsque plusieurs niveaux vous sont accessibles. Chaque offre inclut un quota mensuel de tokens par niveau. La page Usage affiche une barre par niveau, ambre à partir de 80 % et rouge une fois le quota épuisé. Les quotas repartent de zéro le 1er de chaque mois (UTC). AI CodeOps est gratuit pendant la bêta ouverte ; consultez les tarifs.
Lorsque le quota d'un niveau est épuisé, la session continue sur les crédits de l'espace de travail s'il en a assez. Sinon, elle s'arrête et indique ce qui est épuisé. Elle ne passe jamais d'elle-même à un autre niveau.
Apportez votre propre clé
Un espace de travail peut ajouter sa propre clé de fournisseur. Les sessions peuvent s'exécuter avec des clés Anthropic (Claude), OpenAI, Moonshot (Kimi), Z.ai (GLM), DeepSeek, Groq, OpenRouter et Ollama Cloud, ainsi que sur des points de terminaison compatibles OpenAI à une adresse HTTPS publique. Les sessions sur votre propre clé sont facturées par votre fournisseur et ne consomment pas le quota de la plateforme ; le budget de l'espace de travail s'applique toujours. Les clés sont chiffrées au repos. Si votre fournisseur refuse un appel, la session ne se rabat pas discrètement sur la clé de la plateforme.
Pour estimer les dépenses avant de commencer, essayez le calculateur de coûts du codage par IA, gratuit. Le guide de la maîtrise des coûts détaille chaque réglage.
Questions fréquentes
Puis-je plafonner les dépenses d'un seul agent ?
Non. Les limites s'appliquent par espace de travail et par workflow. Les tokens et le coût de chaque étape d'agent sont affichés sur la page de la session, mais il n'existe pas de plafond par agent.
Que se passe-t-il quand une session atteint la limite stricte en cours d'exécution ?
Elle s'arrête avant son prochain appel au modèle, avec un message indiquant que le budget a été atteint. L'appel déjà en cours se termine, si bien qu'une exécution peut dépasser légèrement le plafond.
Apporter ma propre clé API permet-il de contourner le budget ?
Cela contourne le quota de modèles de la plateforme, car votre fournisseur vous facture directement. Le budget de votre espace de travail s'applique toujours aux sessions qui utilisent votre propre clé.
Une session passe-t-elle à un modèle moins cher quand le quota est épuisé ?
Non. Une session ne change jamais de niveau d'elle-même. Elle continue sur les crédits de l'espace de travail s'il y en a assez, sinon elle s'arrête et vous indique ce qui est épuisé. Auto ne choisit que des niveaux pour lesquels il vous reste du quota.
Qui peut modifier le budget ?
Les membres dont le rôle permet de gérer le budget, c'est-à-dire par défaut les rôles Owner, Admin et Billing Admin. Les modifications du budget sont enregistrées dans le journal d'audit.