Квоты и использование
GVR отслеживает число запросов для каждого ключа API по значению
remainingRequests в учётной записи пользователя.
Стоимость запросов по операциям
Квота списывается после успешной обработки. Успешный результат с полом unknown также расходует квоту.
| Операция | Расход квоты |
|---|---|
| Стандартный анализ пола по файлу | 1 запрос |
| Стандартный анализ пола по URL | 1 запрос |
| Определение пола по голосу V2 (улучшенный анализ с обнаружением речи) | 1 запрос |
| Определение пола по голосу V3 (расширенный анализ говорящего) | 2 запроса |
| Возраст по голосу, поддельный голос, эмоции речи, качество аудио, проверка говорящего, анализ изображения или одного имени | 1 запрос за успешный вызов API |
| Проверка CSV | Не расходует запросы; проверяет, хватит ли квоты для обработки строк |
| Обработка CSV | 1 запрос за каждую обработанную строку 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 сначала проверяйте файл, а затем запускайте его масштабную обработку.