Budget Control

Plafonnez votre coût BYOK upstream mensuel. Verdict : BLOCK, DOWNGRADE ou LIGHT_ONLY.

Guardian vous protège des agents runaway au niveau comportemental. Budget Control protège votre portefeuille : vous fixez un plafond mensuel sur le coût upstream que HiWay a le droit d'engendrer contre vos clés fournisseurs, et HiWay l'applique avec un des trois verdicts.

Les trois verdicts

Verdict	Déclenché à	Comportement
`BLOCK`	100% du plafond mensuel	Requêtes rejetées en 402, upstream jamais appelé
`DOWNGRADE`	90% du plafond mensuel	Routage forcé d'un tier vers le bas (ex. heavy → standard)
`LIGHT_ONLY`	95% du plafond mensuel	Chaque requête épinglée au tier light jusqu'au reset mensuel

Configuration

Ouvrez Tableau de bord → Budget Control. Fixez le plafond mensuel USD, les seuils de verdict (défauts ci-dessus), et des webhooks d'alerte Slack / email optionnels. Le plafond se reset le premier du mois UTC.

Ça plafonne le coût *upstream*, pas le markup HiWay

Le plafond suit ce que vos clés fournisseurs se font facturer (OpenAI, Anthropic, etc.). Le markup HiWay étant calculé en % de cette dépense, Budget Control qui réduit votre dépense upstream réduit mécaniquement votre markup.

Forme de la réponse 402

json

{
  "error": {
    "code":           "budget_exceeded",
    "message":        "Plafond BYOK mensuel atteint ($500,00 / $500,00).",
    "verdict":        "BLOCK",
    "cap_usd":        500.0,
    "spent_usd":      500.02,
    "reset_at":       "2026-05-01T00:00:00Z"
  }
}