Часті запитання

Білінг і кредити

Як списуються кредити послуг, коли поповнювати й що означає відповідь 402.

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

Як працює оплата

Поповнення купує кредити послуг, а не грошовий баланс, який зберігає платформа.
Кредити номіновані в доларах США, щоб плату можна було виражати в доларах.
Поповнення починаються з $1. Підписка не потрібна.
Кредити використовуються лише для покриття плати за API платформи. Їх не можна вивести або обміняти на готівку.
Завершені поповнення не підлягають поверненню, зокрема невикористані кредити, окрім випадків, коли цього вимагає обов'язкове застосовне законодавство.

Той самий баланс кредитів оплачує виклики моделей, виклики Data API та виклики Felo API. Вам не потрібен окремий обліковий запис або баланс для кожного постачальника.

Скільки коштує запит

Плата залежить від endpoint:

Поверхня	Основа оплати
Model API	Тарифи на токени для вхідних даних, вихідних даних і кешування, а також будь-які платні інструменти; застосовується множник знижки каналу
Data API	Основа оплати, опублікована для цього endpoint, яка може бути за кожен успішний запит, за кожен повернутий елемент або за фактичне використання
Felo APIs (`/v2`)	Тариф за вивід цього робочого процесу

Ціни моделей показано за 1 млн токенів на сторінці цін і на сторінці кожної моделі. Формулу та приклад розрахунку див. у Моделі та ціни.

Перевірка балансу та поповнення

Відкрийте Console Billing. Консоль показує ваш поточний баланс кредитів, суми поповнень і записи використання. Доступні способи оплати залежать від вашого регіону та показуються під час оформлення замовлення.

Відповідь 402

402 означає, що баланс не покриває виклик:

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

Що робити:

Перевірте баланс у Console Billing.
Поповніть баланс.
Надішліть запит повторно. 402 — це не обмеження швидкості, тому очікування його не усуне.

Для асинхронного завдання 402 під час надсилання означає, що завдання не було створено. Перевірте endpoint статусу завдання, перш ніж надсилати повторно.

Оплата проти обмежень швидкості

Це різні обмеження:

Кредити обмежують, скільки ви можете витратити. Коли вони закінчуються, повертається 402.
Обмеження швидкості обмежують, як швидко ви можете викликати. Їх перевищення повертає 429.

Заголовки 429 і правила повторних спроб див. у Помилки, обмеження та повторні спроби.

Підписки та кредити

Використання API завжди оплачується з кредитів послуг. Єдина поведінка підписки, описана в цій документації, — це звільнення від обмежень швидкості /v2/chat для облікових записів із чинною платною підпискою Felo; це не замінює кредити послуг.

Питання щодо оплати

Щодо спірної плати або поповнення, яке не надійшло, зверніться до підтримки, вказавши:

Електронну пошту облікового запису
Приблизний час плати
request_id з будь-якої пов'язаної помилки
Суму поповнення та платіжний референс

Ніколи не надсилайте свій повний API-ключ.