Перейти к основному содержимому

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

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

Стоимость запросов по операциям​

Квота списывается после успешной обработки. Успешный результат с полом unknown также расходует квоту.

ОперацияРасход квоты
Стандартный анализ пола по файлу1 запрос
Стандартный анализ пола по URL1 запрос
Определение пола по голосу V2 (улучшенный анализ с обнаружением речи)1 запрос
Определение пола по голосу V3 (расширенный анализ говорящего)2 запроса
Возраст по голосу, поддельный голос, эмоции речи, качество аудио, проверка говорящего, анализ изображения или одного имени1 запрос за успешный вызов API
Проверка CSVНе расходует запросы; проверяет, хватит ли квоты для обработки строк
Обработка CSV1 запрос за каждую обработанную строку CSV

API для CSV​

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

Если строк в файле больше, чем оставшихся запросов по ключу, 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 сначала проверяйте файл, а затем запускайте его масштабную обработку.