Felo API PlatformFelo API Platform

Посібники

Моделі та ціни

Розберіться в ID моделей, постачальниках, опублікованих тарифах, знижках, одиницях білінгу та принципах формування ціни запиту.

Ціни моделей публікуються в доларах США. Модель може бути доступною через більш ніж одного вищого постачальника, і кожен постачальник може публікувати різну ціну для клієнта. Цей посібник пояснює, звідки беруться ці ціни та як розрахувати запит до його надсилання.

Як знайти ID моделі

Використовуйте ID моделі, який повертає API. Не будуйте ID з відображуваної назви або slug сторінки.

EndpointПовертає
GET /api/v1/modelsКожну ввімкнену категорію моделей
GET /api/v1/videos/modelsМоделі генерації відео
GET /api/v1/decisions/modelsМоделі рішень

GET /api/v1/models також приймає exclude_video_and_decisions=true і необов'язковий фільтр provider. Виявлення читає каталог і не стягує плату за виклик моделі.

Моделі зображень не мають окремого endpoint для списку. Фільтруйте GET /api/v1/models за model_kind: "image_generation"; див. Генерація зображень.

Для перегляду відкрийте каталог моделей або сторінку цін. Сторінки моделей показують обмеження контексту, протоколи та кожну опубліковану ціну постачальника.

Постачальники та канали

Кожна модель має список публічних каналів. Канал — це одна конфігурація вищого постачальника для цієї моделі, наприклад Anthropic, Azure, Google або канал Claude зі знижкою.

  • is_default позначає канал, який використовується для основної ціни та типового маршруту.
  • runnable позначає, чи канал наразі доступний для запитів.
  • standard_pricing містить стандартні тарифи постачальника.
  • discount_multiplier — це множник продажу від 0 до 1.
  • pricing_mode — це або configured_rates, або upstream_cost.

Сторінка моделі сортує постачальників, ставлячи типового першим, а далі за ціною вхідних даних для клієнта від низької до високої. Щоб явно вибрати постачальника, див. Канали та маршрутизація постачальників.

Як розраховується ціна для клієнта

Для каналу з configured_rates:

customer price = standard rate × discount multiplier

Наприклад, канал зі стандартним тарифом на вхідні дані $1.00 за 1 млн токенів і множником 0.8 стягує $0.80 за 1 млн токенів.

Для каналу з upstream_cost поле standard_pricing дорівнює null, а не нулю. Оплата базується на заявленій вартості генерації, помноженій на зафіксовану знижку. Сторінка моделі показує фактичне правило для цього каналу.

Для зручності тарифи на токени відображаються за 1 мільйон токенів. Під час оплати використовується точність до одного токена з поточного знімка цін.

Одиниці оплати

ОдиницяТипове використанняЯк вимірюється
ТокениЧат, міркування, embeddings, генерація текстуВхідні та вихідні токени окремо; читання й запис кешу можуть мати власні тарифи
Токени зображеньГенерація та редагування зображеньВхідні та вихідні токени зображень окремо; кількість вихідних токенів на зображення залежить від роздільної здатності
ЗапитиДеякі endpoint для зображень і службові endpointФіксована плата за виклик
Секунди або рівніГенерація відеоТривалість, роздільна здатність, референсні вхідні дані або інша опублікована умова

Якщо збігається кілька цінових умов, застосовується перша відповідна умова, указана в цінових деталях моделі. Перед оцінкою великого завдання перевірте рівні на сторінці моделі.

Тарифи кешу

Коли модель публікує input_cache_read або input_cache_write, ці тарифи з'являються в каталозі та на сторінці моделі. Використання кешу повідомляється у відповіді протоколу; влучання в кеш не гарантоване й залежить від вищого постачальника та запиту. Felo не додає окремого перемикача кешу.

Де перевіряти ціни

  • Сторінка цін — порівнюйте моделі та постачальників.
  • Сторінка моделі — повна таблиця тарифів, рівні та умови.
  • API каталогу моделей — ті самі дані в JSON, оновлюються протягом 60 секунд.

Не вшивайте ціни жорстко у свій застосунок. Читайте каталог або показуйте посилання на сторінку цін, щоб зміна ціни не зламала непомітно вашу оцінку витрат.

Оцінка запиту

  1. Знайдіть ID моделі та канал, який плануєте використовувати.
  2. Прочитайте тарифи цього каналу на вхідні дані, вихідні дані та кеш.
  3. Помножте на очікувану кількість токенів або використовуйте тариф за запит чи тривалість для моделей, що не працюють із токенами.
  4. Додайте будь-який застосовний умовний рівень.
  5. Залиште запас на повторні спроби та розкид вихідних даних.

Пов'язані розділи