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ón | Cuota consumida |
|---|---|
| Análisis estándar de género por archivo | 1 solicitud |
| Análisis estándar de género por URL | 1 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 nombres | 1 solicitud por llamada API correcta |
| Validación de CSV | No consume solicitudes; comprueba si la cuota permite procesar las filas |
| Procesamiento de CSV | 1 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
remainingRequestscomo dato de referencia después de cada respuesta de la API. - En los flujos CSV, valida el archivo antes de iniciar un procesamiento extenso.