Найпростіша помилка - ставитися до Rivya API та Rivya Studio як до конкуруючих шляхів.
Їх краще розуміти як два етапи одного продукту. Studio - це місце, де люди візуально досліджують, обирають, перевіряють і продовжують роботу. API - це місце, де стабільний робочий процес стає частиною іншого продукту, скрипта або бекенд-процесу.
Порівняння описує реалізований контракт API. Сторона API застосовна лише тоді, коли доступ до Public API й згадані функції, наприклад вебхуки, увімкнено для розгортання та доступно акаунту.
Якщо ви ще вивчаєте поверхню API, почніть із Що таке Rivya API?. Ця сторінка вужча: як вирішити, чи конкретне завдання належить до Studio або до API.
Рішення в одній таблиці
| Питання | Використовуйте Studio, коли... | Використовуйте API, коли... |
|---|---|---|
| Результат ще дослідницький? | так | ні, робочий процес уже повторюваний |
| Людині потрібно порівнювати результати? | так | лише після того, як ваш застосунок отримує результати |
| Вибір моделі стабільний? | ще ні | так, або вибраний зі списку API-моделей |
| Завданню потрібні референсні медіа? | людина все ще їх готує | ваш застосунок може завантажити їх через Files API |
| Чи має результат оновити іншу систему? | ще ні | так, через опитування або ввімкнені вебхуки |
| Використання кредитів має залишатися видимим? | так, під час тестування | так, але через API-контролі на рівні акаунта |
Йдеться не про те, яка поверхня просунутіша. Йдеться про те, чи завдання готове до автоматизації.
Використовуйте Studio, поки робота ще змінюється
Studio - правильне місце, коли людське рішення все ще є головною роботою.
Це включає:
вибір між моделями для зображень, відео, аудіо або чату
тестування, чи варто зберігати напрям промпта
порівняння візуальних результатів поруч
рішення, чи референсні медіа допомагають або заважають
використання збереженої історії для продовження з попереднього результату
Це особливо справедливо для креативної роботи. Якщо бриф нестабільний, автоматизація запиту зазвичай робить плутанину швидшою, а не меншою.
Використовуйте API, коли робочий процес повторюваний
API стає кращим шляхом, коли вхідні дані й наступні кроки достатньо передбачувані.
Добрі ознаки:
ваш продукт уже знає потрібну модель або категорію моделі
користувацькі вхідні дані можна зіставити зі стабільним тілом запиту
бекенд-завдання може опитувати статус без людини перед екраном
увімкнений вебхук може оновити потрібний запис після завершення завдання
застосунок може пояснити використання кредитів команді або власнику акаунта
На цьому етапі використання Studio для кожного запуску може стати повільнішим шляхом. API дозволяє вашому продукту запускати завдання напряму.
Практична межа: дослідження проти інтеграції
Використовуйте Studio для дослідження.
Використовуйте API для інтеграції.
Дослідження означає:
"Яку модель нам використовувати?"
"Яка форма промпта працює?"
"Чи покращують референсні медіа це завдання?"
"Чи якість результату достатня для цього сценарію використання?"
Інтеграція означає:
"Ця дія користувача має створити одне завдання генерації."
"Це завдання має повторюватися ідемпотентно."
"Цей файл має бути завантажений і прикріплений до запиту моделі."
"Це завершене завдання має оновити запис нашого продукту."
Ця межа не дає API перетворитися на приховану поверхню експериментів.
Як кредити мають впливати на рішення
І Studio, і API використовують кредити одного акаунта Rivya.
Це означає, що поведінка кредитів має бути частиною продуктового дизайну, а не думкою навздогін.
Спершу використовуйте Studio, коли команді ще потрібно зрозуміти форму витрат. Використовуйте API, коли завдання достатньо стабільне, щоб продукт міг пояснити, коли кредити можуть бути зарезервовані або витрачені.
Поточні публічні правила описані в API кредити. Якщо робочий процес надто дорогий, щоб пояснити його власнику акаунта, він ще не готовий до API-автоматизації.
Де файли змінюють вибір
Референсні медіа часто є місцем, де інтеграція стає серйознішою.
У Studio людина може завантажити, перевірити, повторити й вирішити, чи файл достатньо хороший. В API ваш продукт має навмисно обробляти шлях файлу через Files API.
Використовуйте Studio, коли:
референсне зображення, відео або аудіо ще потребує людського очищення
команда не впевнена, який референс має спрямовувати модель
правила файлів ще не зрозумілі користувачу
Використовуйте API, коли:
застосунок може безпечно зібрати файл
вимоги моделі до референсів відомі
файл можна завантажити до запиту генерації або чату
помилки можна показати у вашому власному продукті, не приховуючи, що сталося
Files API - корисний міст, але він не прибирає потребу проєктувати файловий досвід.
Де чат змінює вибір
Чат може належати до будь-якого боку.
Використовуйте Rivya Chat напряму, коли людина досліджує, пише, перевіряє або ухвалює рішення.
Використовуйте Chat API, коли діалог має працювати у вашому власному продукті або серверному процесі. Це може охоплювати повні відповіді без потоку, необов'язкову потокову передачу SSE, сесії, створені через API, і підтримувані файлові вкладення.
Ключове питання - де має жити розмова. Якщо розмова є частиною роботи Rivya, використовуйте Rivya. Якщо розмова є частиною досвіду вашого продукту, використовуйте API.
Коли webhooks є сигналом
Якщо процесу потрібні вебхуки API, він, імовірно, вже вийшов за межі ручного етапу Studio. Перш ніж включати вебхуки до виробничої архітектури, переконайтеся, що їх увімкнено в розгортанні.
Webhooks корисні, коли інша система має реагувати на завершені завдання генерації:
позначити матеріал як готовий
повідомити користувача
просунути крок перевірки вперед
перемістити невдале завдання до підтримки або логіки повторної спроби
Це інтеграційна робота. Studio все ще може бути корисною для тестування шляху моделі, але виробничий цикл належить до API.
Безпечний патерн міграції
Не переносіть цілий робочий процес в API одразу.
Використовуйте таку послідовність:
протестуйте завдання вручну в Studio
запишіть стабільну модель, форму промпта, вхідні файли й очікуваний результат
прочитайте API-моделі і довідник моделі
надішліть одну генерацію через Швидкий старт Rivya API
додайте Files API лише якщо модель потребує референсних медіа
додайте Webhooks лише після того, як опитування працює
додайте Chat API лише якщо продукту потрібні ходи чату поза Studio
Кожен крок має спрощувати експлуатацію робочого процесу, а не просто робити його автоматизованішим.
Коли залишатися в Studio
Залишайтеся в Studio, коли завданню ще потрібні:
суб'єктивна перевірка
формування промпта
візуальне порівняння
дослідження моделей
збережена креативна історія
людина, яка вирішує, чи наступним кроком буде зображення, відео, аудіо або чат
Це не слабкість. Studio створена для цього етапу.
Коли переходити до API
Переходьте до API, коли:
те саме завдання часто повторюється
вхідні дані можна структурувати
модель відома
застосунку потрібно створювати завдання зі свого UI
статус, помилки й кредити можна обробляти зрозуміло
опитування або webhooks підходять до бекенду вашого продукту
API найсильніший, коли перетворює вже зрозумілий робочий процес Rivya на надійну продуктову дію.
Наступний крок у Rivya
Використовуйте Developers, щоб переглянути поверхню API.
Прочитайте Швидкий старт Rivya API перед написанням продакшн-коду.
Прочитайте Автентифікація API перед зберіганням API-ключа.
Прочитайте Як побудувати мультимодальний процес ШІ з Rivya API, якщо далі потрібно поєднати моделі, файли, чат і вебхуки.
Використовуйте Переміщення роботи між Rivya Chat, Image, Video, Audio, якщо проєкт усе ще належить до людської роботи в Studio.
