Saltar al contenido principal

Cuotas y uso

GVR registra el uso de solicitudes por clave API mediante el valor remainingRequests de la cuenta de usuario.

Coste por operación​

La cuota se descuenta cuando el procesamiento se completa correctamente. Un resultado de género unknown también consume cuota.

OperaciónCuota consumida
Análisis estándar de género por archivo1 solicitud
Análisis estándar de género por URL1 solicitud
Género por voz V2 (análisis mejorado con detección de voz)1 solicitud
Género por voz V3 (análisis avanzado por hablante)2 solicitudes
Edad por voz, voz sintética, emociones del habla, calidad de audio, verificación de hablantes, análisis de imágenes o análisis de nombres1 solicitud por llamada API correcta
Validación de CSVNo consume solicitudes; comprueba si la cuota permite procesar las filas
Procesamiento de CSV1 solicitud por cada fila procesada

API de CSV​

El procesamiento de CSV es diferente porque un archivo puede contener muchas filas. La API comprueba el número de filas antes de procesarlas y consume una solicitud por fila.

Si el archivo tiene más filas que solicitudes disponibles en la clave, la API rechaza la solicitud antes de procesar el CSV.

Metadatos de respuesta​

Muchas respuestas correctas de la API incluyen información actualizada sobre la cuota:

{
"remainingRequests": 2999
}

Usa este valor para mostrar el consumo en tu aplicación o sugerir una mejora antes de que se agote la cuota.

Errores de cuota​

Los endpoints de archivos y CSV pueden devolver una respuesta estructurada de límite de solicitudes:

{
"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."
}
}

Los endpoints de nombres individuales pueden devolver:

{
"error": "Insufficient remaining requests"
}

Recomendaciones prácticas​

  • Valida los campos obligatorios antes de llamar a la API.
  • Evita los ciclos de reintentos ante errores de validación.
  • Usa remainingRequests como dato de referencia después de cada respuesta de la API.
  • En los flujos CSV, valida el archivo antes de iniciar un procesamiento extenso.