Коли використовувати Rivya API замість Studio

Найпростіша помилка - ставитися до Rivya API та Rivya Studio як до конкуруючих шляхів.

Їх краще розуміти як два етапи одного продукту. Studio - це місце, де люди візуально досліджують, обирають, перевіряють і продовжують роботу. API - це місце, де стабільний робочий процес стає частиною іншого продукту, скрипта або бекенд-процесу.

Якщо ви ще вивчаєте поверхню API, почніть із Що таке Rivya API?. Ця сторінка вужча: як вирішити, чи конкретне завдання належить до Studio або до API.

Рішення в одній таблиці

Йдеться не про те, яка поверхня просунутіша. Йдеться про те, чи завдання готове до автоматизації.

Використовуйте Studio, поки робота ще змінюється

Studio - правильне місце, коли людське рішення все ще є головною роботою.

Це включає:

• вибір між моделями для зображень, відео, аудіо або чату
• тестування, чи варто зберігати напрям промпта
• порівняння візуальних результатів поруч
• рішення, чи референсні медіа допомагають або заважають
• використання збереженої історії для продовження з попереднього результату

Це особливо справедливо для креативної роботи. Якщо бриф нестабільний, автоматизація запиту зазвичай робить плутанину швидшою, а не меншою.

Використовуйте API, коли робочий процес повторюваний

API стає кращим шляхом, коли вхідні дані й наступні кроки достатньо передбачувані.

Добрі ознаки:

• ваш продукт уже знає потрібну модель або категорію моделі
• користувацькі вхідні дані можна зіставити зі стабільним тілом запиту
• бекенд-завдання може опитувати статус без людини перед екраном
• webhook може оновити правильний запис, коли завдання завершується
• застосунок може пояснити використання кредитів команді або власнику акаунта

На цьому етапі використання Studio для кожного запуску може стати повільнішим шляхом. API дозволяє вашому продукту запускати завдання напряму.

Практична межа: дослідження проти інтеграції

Використовуйте Studio для дослідження.

Використовуйте API для інтеграції.

Дослідження означає:

• "Яку модель нам використовувати?"
• "Яка форма промпта працює?"
• "Чи покращують референсні медіа це завдання?"
• "Чи якість результату достатня для цього сценарію використання?"

Інтеграція означає:

• "Ця дія користувача має створити одне завдання генерації."
• "Це завдання має повторюватися ідемпотентно."
• "Цей файл має бути завантажений і прикріплений до запиту моделі."
• "Це завершене завдання має оновити запис нашого продукту."

Ця межа не дає API перетворитися на приховану поверхню експериментів.

Як кредити мають впливати на рішення

І Studio, і API використовують кредити одного акаунта Rivya.

Це означає, що поведінка кредитів має бути частиною продуктового дизайну, а не думкою навздогін.

Спершу використовуйте Studio, коли команді ще потрібно зрозуміти форму витрат. Використовуйте API, коли завдання достатньо стабільне, щоб продукт міг пояснити, коли кредити можуть бути зарезервовані або витрачені.

Поточні публічні правила описані в API кредити. Якщо робочий процес надто дорогий, щоб пояснити його власнику акаунта, він ще не готовий до API-автоматизації.

Де файли змінюють вибір

Референсні медіа часто є місцем, де інтеграція стає серйознішою.

У Studio людина може завантажити, перевірити, повторити й вирішити, чи файл достатньо хороший. В API ваш продукт має навмисно обробляти шлях файлу через Files API.

Використовуйте Studio, коли:

• референсне зображення, відео або аудіо ще потребує людського очищення
• команда не впевнена, який референс має спрямовувати модель
• правила файлів ще не зрозумілі користувачу

Використовуйте API, коли:

• застосунок може безпечно зібрати файл
• вимоги моделі до референсів відомі
• файл можна завантажити до запиту генерації або чату
• помилки можна показати у вашому власному продукті, не приховуючи, що сталося

Files API - корисний міст, але він не прибирає потребу проєктувати файловий досвід.

Де чат змінює вибір

Чат може належати до будь-якого боку.

Використовуйте Rivya Chat напряму, коли людина досліджує, пише, перевіряє або ухвалює рішення.

Використовуйте Chat API, коли хід чату має жити у вашому власному продукті або серверному робочому процесі. Це може включати ходи без streaming, необов'язковий SSE streaming, сесії, створені через API, і підтримувані файлові вкладення.

Ключове питання - де має жити розмова. Якщо розмова є частиною роботи Rivya, використовуйте Rivya. Якщо розмова є частиною досвіду вашого продукту, використовуйте API.

Коли webhooks є сигналом

Якщо вашому робочому процесу потрібні API Webhooks, він, ймовірно, вже пройшов ручний етап Studio.

Webhooks корисні, коли інша система має реагувати на завершені завдання генерації:

• позначити матеріал як готовий
• повідомити користувача
• просунути крок перевірки вперед
• перемістити невдале завдання до підтримки або логіки повторної спроби

Це інтеграційна робота. Studio все ще може бути корисною для тестування шляху моделі, але виробничий цикл належить до API.

Безпечний патерн міграції

Не переносіть цілий робочий процес в API одразу.

Використовуйте таку послідовність:

1. протестуйте завдання вручну в Studio
2. запишіть стабільну модель, форму промпта, вхідні файли й очікуваний результат
3. прочитайте API-моделі і довідник моделі
4. надішліть одну генерацію через Швидкий старт Rivya API
5. додайте Files API лише якщо модель потребує референсних медіа
6. додайте Webhooks лише після того, як опитування працює
7. додайте Chat API лише якщо продукту потрібні ходи чату поза Studio

Кожен крок має спрощувати експлуатацію робочого процесу, а не просто робити його автоматизованішим.

Коли залишатися в Studio

Залишайтеся в Studio, коли завданню ще потрібні:

• суб'єктивна перевірка
• формування промпта
• візуальне порівняння
• дослідження моделей
• збережена креативна історія
• людина, яка вирішує, чи наступним кроком буде зображення, відео, аудіо або чат

Це не слабкість. Studio створена для цього етапу.

Коли переходити до API

Переходьте до API, коли:

• те саме завдання часто повторюється
• вхідні дані можна структурувати
• модель відома
• застосунку потрібно створювати завдання зі свого UI
• статус, помилки й кредити можна обробляти зрозуміло
• опитування або webhooks підходять до бекенду вашого продукту

API найсильніший, коли перетворює вже зрозумілий робочий процес Rivya на надійну продуктову дію.

Наступний крок у Rivya

• Використовуйте Developers, щоб переглянути поверхню API.
• Прочитайте Швидкий старт Rivya API перед написанням продакшн-коду.
• Прочитайте Автентифікація API перед зберіганням API-ключа.
• Прочитайте Як побудувати мультимодальний AI-робочий процес із Rivya API, якщо наступне питання - як поєднати моделі, файли, чат і webhooks.
• Використовуйте Переміщення роботи між Rivya Chat, Image, Video, Audio, якщо проєкт усе ще належить до людської роботи в Studio.