Flux quotas et crédits IA
Objectif du flux
Limiter, mesurer et facturer ou décompter les usages IA afin de garder une IA utile, soutenable et économiquement contrôlée.
Acteurs/systèmes impliqués
- Utilisateur, acteur, mairie ou administrateur.
- API Laravel.
- AI Gateway.
- Service quotas/crédits.
- Module Monetization.
- Provider IA.
- Logs coûts/tokens.
Étapes principales
- Une demande IA est reçue par Laravel.
- Laravel identifie l’utilisateur, l’offre, l’acteur ou la commune.
- Le service quotas vérifie les droits IA disponibles.
- Le coût estimé de la tâche est évalué.
- La requête est autorisée, limitée ou refusée.
- Après exécution, l’usage réel est enregistré.
- Les crédits ou quotas sont décrémentés.
- Les dépassements ou achats additionnels sont gérés via l’offre ou les boosts.
Données manipulées
- Identifiant utilisateur, acteur ou commune.
- Offre active.
- Quota IA.
- Crédits IA disponibles.
- Type de tâche IA.
- Provider/modèle utilisé.
- Tokens estimés et consommés.
- Coût estimé et coût réel.
Règles sécurité
- Les quotas doivent être vérifiés avant appel provider.
- Les coûts doivent être journalisés.
- Les crédits ne doivent pas être décrémentés uniquement côté frontend.
- Les offres premium ne doivent pas permettre un coût illimité.
- Les erreurs provider ne doivent pas produire un double décompte non contrôlé.
Erreurs/points de vigilance
- Quota épuisé.
- Crédit insuffisant.
- Estimation coût trop faible.
- Provider plus coûteux que prévu.
- Retry provoquant un double coût.
- Désynchronisation entre paiement, crédits et usage.
État actuel vs cible
| Sujet | État actuel visible | Vision cible |
|---|---|---|
| Quotas | Quotas IA documentés. | Contrôle avant appel et suivi par offre. |
| Crédits | Crédits IA documentés. | Décompte centralisé côté Laravel. |
| Business | IA intégrée aux offres. | Gratuit limité, offres avancées et crédits additionnels possibles. |
Diagramme Mermaid
TODO / points à confirmer
- Unité exacte des crédits IA.
- Quotas par offre.
- Règles de décompte en cas d’échec.
- Seuils d’alerte coût.
- Lien précis avec abonnements, boosts et offres mairie.