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.

API à requête unique​

La plupart des appels consomment une requête après un traitement réussi.

Exemples:

  • requête de détection du genre à partir d’un fichier audio
  • requête d’estimation de l’âge par la voix
  • requête de détection d’une voix synthétique
  • requête de détection du genre par image
  • requête d’estimation de l’âge par image
  • requête d’analyse d’un nom

API CSV​

Le traitement CSV fonctionne différemment, car un fichier peut contenir de nombreuses lignes. Le système vérifie leur nombre et peut consommer une requête pour chaque ligne traitée.

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.