Quotas et utilisation
GVR suit l’utilisation des requêtes pour chaque clé API grâce à la valeur
remainingRequests du compte utilisateur.
Coût des requêtes par opération
Le quota est déduit après la réussite du traitement. Un résultat de genre unknown consomme également du quota.
| Opération | Coût du quota |
|---|---|
| Analyse de genre par fichier (standard) | 1 requête |
| Analyse de genre par URL (standard) | 1 requête |
| Genre par voix V2 (analyse améliorée avec détection de la parole) | 1 requête |
| Genre par voix V3 (analyse avancée par locuteur) | 2 requêtes |
| Âge vocal, voix synthétique, émotions vocales, qualité audio, vérification du locuteur, analyse d’image ou analyse d’un nom | 1 requête par appel API réussi |
| Validation CSV | Aucune requête ; vérifie que le quota permet de traiter les lignes |
| Traitement CSV | 1 requête par ligne CSV traitée |
API CSV
Le traitement CSV est différent, car un fichier peut contenir de nombreuses lignes. L’API vérifie leur nombre avant le traitement et consomme une requête par ligne.
Si le fichier contient plus de lignes que la clé n’a de requêtes disponibles, l’API rejette la requête avant de traiter le CSV.
Métadonnées de réponse
De nombreuses réponses réussies incluent les informations actualisées sur le quota :
{
"remainingRequests": 2999
}
Utilisez cette valeur pour afficher la consommation dans votre application ou pour proposer une mise à niveau avant épuisement du quota.
Erreurs de quota
Les points de terminaison de fichiers et de CSV peuvent renvoyer une réponse structurée de dépassement de limite :
{
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "You have exceeded your free tier limit of 50 requests.",
"detailedMessage": "Insufficient remaining requests. Required: 1, Available: 0",
"details": {
"limit": 50,
"used": 50,
"reset_date": "2026-07-01T00:00:00.000Z"
},
"suggested_action": "Please upgrade to a premium plan to continue using the API."
}
}
Les points de terminaison d’analyse d’un nom peuvent renvoyer :
{
"error": "Insufficient remaining requests"
}
Conseils pratiques
- Vérifiez les champs obligatoires avant d’appeler l’API.
- Évitez les boucles de nouvelles tentatives en cas d’erreur de validation.
- Après chaque réponse, utilisez
remainingRequestscomme valeur de référence. - Pour les fichiers CSV, validez le contenu avant de lancer un traitement volumineux.