Aller au contenu principal

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érationCoû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 nom1 requête par appel API réussi
Validation CSVAucune requête ; vérifie que le quota permet de traiter les lignes
Traitement CSV1 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 remainingRequests comme valeur de référence.
  • Pour les fichiers CSV, validez le contenu avant de lancer un traitement volumineux.