Nejjednodušší chyba je brát Rivya API a Rivya Studio jako konkurenční cesty.
Lépe se chápou jako dvě fáze stejného produktu. Studio je místo, kde lidé vizuálně zkoumají, vybírají, revidují a pokračují v práci. API je místo, kde se stabilní pracovní postup stane součástí jiného produktu, skriptu nebo backendového procesu.
Pokud se API plochu teprve učíte, začněte článkem Co je Rivya API?. Tato stránka je užší: jak rozhodnout, zda konkrétní úkol patří do Studia nebo do API.
Rozhodnutí v jedné tabulce
| Otázka | Použijte Studio, když... | Použijte API, když... |
|---|---|---|
| Je výstup pořád průzkumný? | ano | ne, pracovní postup je už opakovatelný |
| Potřebuje člověk porovnat výsledky? | ano | až poté, co vaše aplikace obdrží výsledky |
| Je volba modelu stabilní? | ještě ne | ano, nebo je vybraná ze seznamu modelů API |
| Potřebuje úkol referenční média? | člověk je pořád připravuje | vaše aplikace je umí nahrát přes Files API |
| Má výsledek aktualizovat jiný systém? | zatím ne | ano, přes polling nebo webhooky |
| Má využití kreditů zůstat viditelné? | ano, během testování | ano, ale přes API kontroly na úrovni účtu |
Nejde o to, která plocha je pokročilejší. Jde o to, zda je úkol připravený k automatizaci.
Používejte Studio, dokud se práce stále mění
Studio je správné místo, když je lidské rozhodnutí pořád hlavní částí práce.
To zahrnuje:
- výběr mezi obrazovými, video, audio nebo chatovými modely
- testování, zda stojí za to udržet určitý směr promptu
- porovnávání vizuálních výsledků vedle sebe
- rozhodování, zda referenční média pomáhají nebo škodí
- používání uložené historie k pokračování z předchozího výsledku
To platí zejména pro kreativní práci. Pokud brief není stabilní, automatizace požadavku obvykle zrychlí zmatek, ne ho zmenší.
Používejte API, když je pracovní postup opakovatelný
API je lepší cesta, když jsou vstupy a další kroky dost předvídatelné.
Dobré signály:
- váš produkt už ví, jaký model nebo kategorii modelu potřebuje
- uživatelský vstup lze převést do stabilního těla požadavku
- backendová úloha umí pollovat stav, aniž by někdo sledoval obrazovku
- webhook umí aktualizovat správný záznam po dokončení úlohy
- aplikace umí týmu nebo vlastníkovi účtu vysvětlit využití kreditů
V té chvíli může být používání Studia pro každý běh pomalejší cestou. API umožní vašemu produktu spustit úlohu přímo.
Praktická hranice: objevování versus integrace
Použijte Studio pro objevování.
Použijte API pro integraci.
Objevování znamená:
- „Který model máme použít?“
- „Jaký tvar promptu funguje?“
- „Zlepšují referenční média tento úkol?“
- „Je kvalita výstupu dost dobrá pro tento případ použití?“
Integrace znamená:
- „Tato uživatelská akce má vytvořit jednu generační úlohu.“
- „Tato úloha se má idempotentně zopakovat.“
- „Tento soubor se má nahrát a připojit k požadavku na model.“
- „Tato dokončená úloha má aktualizovat záznam v našem produktu.“
Tato hranice brání tomu, aby se API stalo skrytou experimentální plochou.
Jak mají kredity ovlivnit rozhodnutí
Studio i API čerpají ze stejných kreditů účtu Rivya.
To znamená, že chování kreditů má být součástí návrhu produktu, ne dodatečná myšlenka.
Použijte nejdřív Studio, když tým ještě potřebuje pochopit tvar nákladů. API použijte, když je úkol dost stabilní na to, aby produkt uměl vysvětlit, kdy mohou být kredity rezervované nebo spotřebované.
Aktuální veřejná pravidla najdete v API kreditech. Pokud je pracovní postup příliš drahý na to, aby se dal vysvětlit vlastníkovi účtu, ještě není připravený na API automatizaci.
Kde soubory mění volbu
Referenční média jsou často místem, kde se integrace stává vážnější.
Ve Studiu může člověk soubor nahrát, prohlédnout, zopakovat pokus a rozhodnout, zda je dost dobrý. V API musí váš produkt zacházet s cestou souboru záměrně přes Files API.
Použijte Studio, když:
- referenční obrázek, video nebo audio stále potřebuje lidské vyčištění
- tým si není jistý, která reference má model vést
- pravidla souborů ještě nejsou pro uživatele jasná
Použijte API, když:
- aplikace umí soubor bezpečně získat
- referenční požadavky modelu jsou známé
- soubor lze nahrát před generačním nebo chatovým požadavkem
- chyby lze ukázat ve vašem vlastním produktu bez zakrytí toho, co se stalo
Files API je užitečný most, ale neodstraňuje potřebu navrhnout zkušenost se soubory.
Kde chat mění volbu
Chat může patřit na obě strany.
Použijte Rivya Chat přímo, když člověk zkoumá, píše, reviduje nebo rozhoduje.
Použijte Chat API, když má chatový tah žít uvnitř vašeho vlastního produktu nebo serverového pracovního postupu. To může zahrnovat nestreamované tahy, volitelné SSE streamování, relace vytvořené přes API a podporované přílohy souborů.
Klíčová otázka je, kde má konverzace žít. Pokud je konverzace součástí práce v Rivya, použijte Rivya. Pokud je konverzace součástí zkušenosti ve vašem produktu, použijte API.
Kdy jsou webhooky signálem
Pokud váš pracovní postup potřebuje API Webhooks, pravděpodobně už je za ruční fází ve Studiu.
Webhooky jsou užitečné, když jiný systém potřebuje reagovat na dokončené generační úlohy:
- označit podklad jako připravený
- upozornit uživatele
- posunout krok revize dál
- přesunout selhanou úlohu do podpory nebo logiky opakování
To je integrační práce. Studio může být pořád užitečné pro testování modelové cesty, ale produkční smyčka patří do API.
Bezpečný migrační vzorec
Nepřesouvejte celý pracovní postup do API najednou.
Použijte tuto posloupnost:
- otestujte úkol ručně ve Studiu
- zapište stabilní model, tvar promptu, vstupní soubory a očekávaný výsledek
- přečtěte si Modely API a referenci modelů
- odešlete jednu generaci přes Rychlý start Rivya API
- přidejte Files API jen tehdy, pokud model vyžaduje referenční média
- přidejte Webhooks až poté, co funguje polling
- přidejte Chat API jen tehdy, pokud produkt potřebuje chatové tahy mimo Studio
Každý krok má pracovní postup zjednodušit, ne jen víc zautomatizovat.
Kdy zůstat ve Studiu
Zůstaňte ve Studiu, když úkol stále potřebuje:
- subjektivní revizi
- tvarování promptu
- vizuální porovnání
- průzkum modelů
- uloženou kreativní historii
- člověka, který rozhodne, zda dalším krokem je obrázek, video, audio nebo chat
To není slabina. Studio je pro tuto fázi navržené.
Kdy přejít do API
Přejděte do API, když:
- stejný úkol se často opakuje
- vstup lze strukturovat
- model je známý
- aplikace potřebuje vytvářet úlohy ze svého vlastního UI
- stav, chyby a kredity lze jasně obsloužit
- polling nebo webhooky zapadají do backendu produktu
API je nejsilnější, když z už pochopeného pracovního postupu Rivya udělá spolehlivou produktovou akci.
Další krok v Rivya
- Použijte Developers k náhledu API plochy.
- Před psaním produkčního kódu si přečtěte Rychlý start Rivya API.
- Před uložením API klíče si přečtěte Ověřování API.
- Pokud další otázkou je, jak propojit modely, soubory, chat a webhooky, přečtěte si Jak vytvořit multimodální AI pracovní postup s Rivya API.
- Pokud projekt stále patří do lidsky vedené práce ve Studiu, použijte Přesouvání práce mezi Rivya Chatem, Image, Videem a Audiem.
