Работа с API

Лимиты

Скопировать

Информация о лимитах запросов и квотах на использование API.

Глобальные лимиты: Создание дополнительных аккаунтов или API ключей не влияет на ваши лимиты, так как мы управляем пропускной способностью глобально. Однако для разных моделей действуют разные лимиты, поэтому вы можете распределить нагрузку, если столкнетесь с ограничениями.

Типы ограничений

В NeuroAPI действуют два основных типа ограничений: лимиты на скорость запросов и квоты на использование.

Лимиты скорости определяют, как часто вы можете отправлять запросы. Они могут различаться для разных моделей.
Квоты контролируют общее количество токенов, которое вы можете использовать. Квота может быть привязана к вашему аккаунту или конкретному API-ключу.

Отслеживание использования

Проверка расхода через API

Для проверки текущего расхода выполните GET запрос к эндпоинту использования:

const response = await fetch('https://neuroapi.host/v1/dashboard/billing/usage', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer <YOUR_API_KEY>',
  },
});

const usage = await response.json();
console.log('Использовано:', usage.total_usage);

Ответ будет содержать информацию о вашем расходе:

{
  "object": "list",
  "total_usage": 1234  // Общее использование в центах (USD), т.е. 1234 = $12.34
}

Информация в ответах API

Каждый успешный ответ от моделей содержит поле usage с детализацией по потраченным токенам:

// Каждый ответ API содержит информацию об использовании
{
  "id": "chatcmpl-xxxxxxxxxxxxxx",
  "choices": [...],
  "usage": {
    "prompt_tokens": 10,        // Токены в запросе
    "completion_tokens": 20,    // Токены в ответе
    "total_tokens": 30          // Общее количество токенов
  },
  "model": "gpt-5-mini"
}

Мониторинг в личном кабинете

Вы можете отслеживать статистику использования и управлять API ключами в соответствующих разделах личного кабинета.

Коды ошибок лимитов

При превышении лимитов API возвращает следующие коды ошибок:

HTTP Код	Описание	Решение
429	Too Many Requests - превышен лимит скорости	Подождите и повторите запрос позже
403	Forbidden - недостаточно квоты, токен заблокирован или истек	Пополните баланс или проверьте статус токена