Квоты и использование

GVR отслеживает число запросов для каждого ключа API по значению remainingRequests в учётной записи пользователя.

API с оплатой за запрос

После успешной обработки большинство вызовов API расходуют один запрос.

Примеры:

• запрос определения пола по аудиофайлу
• запрос определения возраста по голосу
• запрос обнаружения поддельного голоса
• запрос определения пола по изображению
• запрос определения возраста по изображению
• запрос анализа одного имени

API для CSV

Обработка CSV устроена иначе: один файл может содержать много строк. Для CSV проверяется число строк, и за каждую обработанную строку может расходоваться один запрос.

Если строк в файле больше, чем оставшихся запросов по ключу, API отклонит запрос до начала обработки CSV.

Метаданные ответа

Многие успешные ответы API содержат обновлённую информацию о квоте:

{
  "remainingRequests": 2999
}

Используйте это значение, чтобы показывать остаток в приложении или предлагать сменить план до исчерпания квоты.

Ошибки квоты

Конечные точки для файлов и CSV могут возвращать структурированный ответ об ограничении частоты запросов:

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

Конечные точки для анализа одного имени могут возвращать:

{
  "error": "Insufficient remaining requests"
}

Практические рекомендации

• Проверяйте обязательные поля перед вызовом API.
• Не повторяйте запросы циклически при ошибках проверки данных.
• Считайте remainingRequests достоверным остатком после каждого ответа API.
• При работе с CSV сначала проверяйте файл, а затем запускайте его масштабную обработку.