Cuotas y uso

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

API con consumo de una solicitud

La mayoría de las llamadas a la API consumen una solicitud cuando el procesamiento se completa correctamente.

Ejemplos:

• solicitud de género por voz mediante archivo
• solicitud de edad por voz
• solicitud de detección de voz sintética
• solicitud de género por imagen
• solicitud de edad por imagen
• solicitud de análisis de un nombre

API de CSV

El procesamiento CSV es diferente porque un archivo puede contener muchas filas. El sistema comprueba el número de filas y puede consumir una solicitud por cada fila procesada.

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.