Limites de débit et budgets sur Velqa.dev
Velqa applique des limites par clé API pour protéger votre solde et lisser la charge : un débit maximal (RPM / TPM) par modèle, et un budget mensuel en USD par clé. Ces limites dépendent de votre plan et du modèle ; les valeurs exactes sont affichées dans le tableau de bord.
Les trois limites
| Limite | Ce qu'elle mesure | Portée |
|---|---|---|
| RPM | Requêtes par minute | par clé × modèle |
| TPM | Tokens par minute | par clé × modèle |
| Budget mensuel (USD) | Dépense cumulée sur le mois | par clé |
- RPM / TPM : plafonds de débit court terme. Ils dépendent du plan et du modèle — un modèle Premium a des plafonds plus bas qu'un modèle Fast. Les valeurs exactes sont visibles dans le tableau de bord, à côté de chaque clé.
- Budget mensuel : un montant maximal de dépense par clé, que vous fixez vous-même. Utile pour isoler un projet ou un environnement (prod / staging) sans risque de dépassement.
Comment les limites sont appliquées
- Dépassement de RPM ou TPM → réponse HTTP 429 (Too Many Requests). Réessayez après une courte pause (backoff exponentiel), ou répartissez la charge sur la minute.
- Budget mensuel de la clé épuisé, ou solde Boost insuffisant → réponse HTTP 402 (Payment Required). Rechargez, augmentez le budget de la clé, ou attendez le renouvellement mensuel.
Les plans (Starter, Dev, Pro) fixent des plafonds globaux ; le mode Recharge Boost consomme un solde prépayé. Voir Modèles disponibles pour la disponibilité par plan.
Configurer les limites par clé
Vous définissez le budget mensuel et, le cas échéant, les plafonds de débit par clé depuis le tableau de bord. Voir le guide Clés API pour la marche à suivre. Bonne pratique : une clé par projet/environnement, avec un budget dédié.
Interaction avec velqa-auto et le fallback Boost
Si vous utilisez le routeur velqa-auto (sélection automatique du modèle) et/ou le fallback Boost, un dépassement de plafond de plan peut basculer automatiquement la requête sur votre solde Boost au lieu d'échouer, selon votre configuration. Voir Fallback Boost pour le détail du comportement.
Voir aussi
- Codes d'erreur — 429, 402 et comment y réagir.
- Clés API — créer une clé et fixer son budget.
- Fallback Boost — bascule automatique sur le solde prépayé.