Felo API PlatformFelo API Platform

FAQ

Оплата и кредиты

Узнайте, как списываются сервисные кредиты, когда нужно пополнение и что означает ответ 402.

Использование API на Felo API Platform предоплатное. Вы покупаете сервисные кредиты в долларах США, и каждый запрос списывается с этого баланса по применимому тарифу.

Как устроена оплата

  • При пополнении вы покупаете сервисные кредиты, а не денежный баланс, который хранит платформа.
  • Кредиты выражены в долларах США, поэтому списания можно указывать в долларах.
  • Пополнение начинается с $1. Подписка не требуется.
  • Кредиты используются только для покрытия расходов на API платформы. Их нельзя вывести или обменять на наличные.
  • Завершённые пополнения не возвращаются, включая неиспользованные кредиты, кроме случаев, когда этого требует применимое законодательство.

Один и тот же баланс кредитов оплачивает вызовы моделей, Data API и Felo API. Не нужно заводить отдельный аккаунт или баланс для каждого поставщика.

Сколько стоит запрос

Стоимость зависит от endpoint'а:

ПоверхностьОснова биллинга
Model APIТарифы на input, output и кэш tokens плюс платные инструменты; применяется множитель скидки канала
Data APIОпубликованная для endpoint'а основа: за успешный запрос, за возвращённый элемент или по фактическому использованию
Felo APIs (/v2)Тариф за результат этого рабочего процесса

Цены моделей показаны за 1M tokens на странице цен и на странице каждой модели. Формула и пример расчёта — в разделе Модели и цены.

Проверить баланс и пополнить

Откройте Console Billing. Консоль показывает текущий баланс кредитов, суммы пополнений и историю использования. Доступные способы оплаты зависят от региона и отображаются при оформлении.

Ответ 402

402 означает, что баланса не хватает на вызов:

{
  "status": 402,
  "code": "INSUFFICIENT_CREDITS",
  "message": "...",
  "request_id": "..."
}

Что делать:

  1. Проверьте баланс в Console Billing.
  2. Пополните его.
  3. Отправьте запрос заново. 402 — это не лимит запросов, ожидание его не снимет.

Для асинхронной задачи 402 при отправке означает, что задача не была создана. Перед повторной отправкой проверьте статус задачи.

Оплата и лимиты запросов

Это разные ограничения:

  • Кредиты ограничивают, сколько можно потратить. Когда они кончаются, возвращается 402.
  • Лимиты запросов ограничивают, как часто можно вызывать API. При превышении возвращается 429.

Заголовки 429 и правила повторов см. в разделе Ошибки, лимиты и повторные попытки.

Подписки и кредиты

Использование API всегда оплачивается сервисными кредитами. Единственное поведение подписки, описанное в этой документации, — освобождение от лимитов /v2/chat для аккаунтов с действующей платной подпиской Felo; оно не заменяет сервисные кредиты.

Вопросы по оплате

Если вы не согласны со списанием или пополнение не пришло, обратитесь в поддержку и укажите:

  • email аккаунта
  • примерное время списания
  • request_id из связанной ошибки
  • сумму пополнения и платёжную ссылку

Никогда не отправляйте полный API key.

Связанные разделы