Надёжность

    Лимиты

    Информация о лимитах запросов и балансе на использование 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 КодОписаниеРешение
    429Too Many Requests - превышен лимит скоростиПодождите и повторите запрос позже
    403 Forbidden - недостаточно средств на балансе, токен заблокирован или истек Пополните баланс или проверьте статус токена

    Рекомендации по оптимизации

    Советы по эффективному использованию лимитов:

    • • Используйте пакетную обработку для множественных запросов
    • • Реализуйте экспоненциальную задержку при получении ошибок 429
    • • Мониторьте расход баланса через Dashboard
    • • Кэшируйте результаты для повторяющихся запросов
    • • Используйте потоковую передачу для длинных ответов