Rivya AI
Rivya Journal
Autor
Kategorie
Obsah
Pokračujte v objevování
Pokračujte souvisejícími průvodci, produktovými poznámkami a rozbory workflow od týmu Rivya.
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.
Srovnání popisuje implementovaný kontrakt API. Strana API platí jen tehdy, když jsou přístup k veřejnému API a uvedené funkce, například webhooky, zapnuté pro nasazení a dostupné účtu.
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.
| 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 pravidelné dotazování nebo zapnuté 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.
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 zadání není ustálené, automatizace požadavku obvykle zmatek urychlí, místo aby ho omezila.
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
zapnutý webhook může po dokončení úlohy aktualizovat příslušný záznam
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.
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.
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.
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ý referenční podklad 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.
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.
Pokud proces potřebuje Webhooky API, nejspíš už překročil ruční fázi Studia. Než webhooky zahrnete do produkčního návrhu, ověřte, že jsou v nasazení zapnuté.
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.
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
webhooky přidejte až poté, co spolehlivě funguje dotazování na stav
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.
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é.
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
pravidelné dotazování nebo webhooky zapadají do serverové části produktu
API je nejsilnější, když z už pochopeného pracovního postupu Rivya udělá spolehlivou produktovou akci.
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.
Přečtěte si Jak vytvořit multimodální pracovní postup s AI pomocí Rivya API, pokud je další otázkou propojení modelů, souborů, chatu a webhooků.
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.
