A legkönnyebb hiba az, ha a Rivya API-t és a Rivya Studiót versengő útvonalakként kezeli.
Jobb úgy érteni őket, mint ugyanannak a terméknek két szakaszát. A Studio az a hely, ahol az emberek vizuálisan feltárnak, választanak, ellenőriznek és folytatnak munkát. Az API az a hely, ahol egy stabil munkafolyamat egy másik termék, szkript vagy backend folyamat részévé válik.
Az összehasonlítás a megvalósított API-szerződést írja le. Az API-oldal csak akkor alkalmazható, ha a Public API-hozzáférés és az említett funkciók, például a webhookok, engedélyezve vannak a telepítéshez és elérhetők a fióknak.
Ha még tanulja az API felületét, kezdje a Mi az a Rivya API? cikkel. Ez az oldal szűkebb: hogyan döntse el, hogy egy konkrét feladat a Studióba vagy az API-ba tartozik.
A döntés egy táblázatban
| Kérdés | Használja a Studiót, amikor... | Használja az API-t, amikor... |
|---|---|---|
| A kimenet még feltáró? | igen | nem, a munkafolyamat már ismételhető |
| Szükséges, hogy egy ember összehasonlítsa az eredményeket? | igen | csak azután, hogy az alkalmazása megkapta az eredményeket |
| Stabil a modellválasztás? | még nem | igen, vagy az API modelllistából van kiválasztva |
| Szüksége van a feladatnak referenciamédiára? | egy ember még előkészíti | az alkalmazása fel tudja tölteni Files API-n keresztül |
| Frissítenie kell az eredménynek egy másik rendszert? | még nem | igen, lekérdezéssel vagy engedélyezett webhookokkal |
| Láthatónak kell maradnia a kreditfelhasználásnak? | igen, tesztelés közben | igen, de fiókszintű API-kontrollokon keresztül |
Ez nem arról szól, melyik felület fejlettebb. Arról szól, hogy a feladat készen áll-e automatizálásra.
Használja a Studiót, amíg a munka még változik
A Studio a megfelelő hely, amikor az emberi döntés még maga a fő munka.
Ide tartozik:
kép-, videó-, audio- vagy chatmodellek közötti választás
annak tesztelése, érdemes-e megtartani egy promptirányt
vizuális eredmények egymás melletti összehasonlítása
annak eldöntése, hogy a referenciamédia segít vagy árt
mentett előzmények használata korábbi eredményből való folytatáshoz
Ez különösen igaz a kreatív munkára. Ha a feladatleírás nem stabil, a kérés automatizálása általában gyorsabban növeli a zavart, ahelyett hogy csökkentené.
Használja az API-t, amikor a munkafolyamat ismételhető
Az API akkor válik jobb úttá, amikor a bemenetek és a következő lépések elég kiszámíthatóak.
Jó jelek:
a terméke már tudja, melyik modellre vagy modellkategóriára van szüksége
a felhasználói bemenet stabil kéréstörzzsé alakítható
egy backend feladat képes állapotot lekérdezni anélkül, hogy valaki képernyőt figyelne
egy engedélyezett webhook a feladat befejezésekor frissítheti a megfelelő rekordot
az alkalmazás el tudja magyarázni a kreditfelhasználást a csapatnak vagy a fióktulajdonosnak
Ezen a ponton minden futtatásra Studiót használni lassabb út lehet. Az API lehetővé teszi, hogy a terméke közvetlenül indítsa el a feladatot.
Gyakorlati határ: feltárás kontra integráció
Használja a Studiót feltáráshoz.
Használja az API-t integrációhoz.
A feltárás ezt jelenti:
„Melyik modellt használjuk?”
„Milyen promptforma működik?”
„Javítja ez a feladatot a referenciamédia?”
„Elég jó a kimeneti minőség ehhez az esethez?”
Az integráció ezt jelenti:
„Ez a felhasználói művelet hozzon létre egy generálási feladatot.”
„Ezt a feladatot idempotensen lehessen újrapróbálni.”
„Ezt a fájlt fel kell tölteni és modellkéréshez csatolni.”
„Ez a befejezett feladat frissítse a termékrekordunkat.”
Ez a határ megakadályozza, hogy az API rejtett kísérleti felületté váljon.
Hogyan befolyásolják a kreditek a döntést
A Studio és az API használata ugyanazokból a Rivya fiókkreditekből költ.
Ez azt jelenti, hogy a kreditviselkedésnek a terméktervezés része kell legyen, nem utólagos gondolat.
Használja először a Studiót, amikor a csapatnak még meg kell tanulnia a költségformát. Használja az API-t, amikor a feladat elég stabil ahhoz, hogy a termék elmagyarázza, mikor foglalhatók le vagy fogyaszthatók el kreditek.
Az aktuális nyilvános szabályokért olvassa el az API kreditek oldalt. Ha egy munkafolyamat túl drága ahhoz, hogy elmagyarázza a fióktulajdonosnak, még nem áll készen API-automatizálásra.
Hol változtatnak a fájlok a választáson
A referenciamédia gyakran az a pont, ahol egy integráció komolyabbá válik.
A Studióban egy ember feltöltheti, megvizsgálhatja, újrapróbálhatja és eldöntheti, elég jó-e a fájl. Az API-ban a termékének tudatosan kell kezelnie a fájlutat a Files API segítségével.
Használja a Studiót, amikor:
a referenciakép, videó vagy hanganyag még kézi előkészítést igényel
a csapat nem biztos abban, melyik referencia vezesse a modellt
a fájlszabályok még nem világosak a felhasználó számára
Használja az API-t, amikor:
az alkalmazás biztonságosan be tudja gyűjteni a fájlt
ismertek a modell referenciakövetelményei
a fájl feltölthető a generálási vagy chatkérés előtt
a hibák megjeleníthetők a saját termékében anélkül, hogy elfednék, mi történt
A Files API hasznos híd, de nem veszi le a fájlélmény megtervezésének szükségét.
Hol változtatja meg a chat a választást
A chat mindkét oldalhoz tartozhat.
Használja közvetlenül a Rivya Chatet, amikor egy ember feltár, ír, ellenőriz vagy dönt.
Használja a Chat API útvonalat, amikor a chatfordulónak a saját termékében vagy szerveroldali munkafolyamatában kell élnie. Ez tartalmazhat nem streamelt fordulókat, opcionális SSE streaminget, API-val létrehozott munkameneteket és támogatott fájlmellékleteket.
A kulcskérdés az, hol kell élnie a beszélgetésnek. Ha a beszélgetés a Rivya-munka része, használja a Rivyát. Ha a beszélgetés a saját termékélményének része, használja az API-t.
Amikor a webhook már az automatizálás jele
Ha a munkafolyamatnak API-webhookokra van szüksége, valószínűleg túljutott a kézi Studio-szakaszon. Mielőtt a webhookokat a gyártási terv részének tekinti, ellenőrizze, hogy engedélyezve vannak-e a telepítésben.
A webhookok akkor hasznosak, amikor egy másik rendszernek reagálnia kell befejezett generálási feladatokra:
az elkészült anyag megjelölése
felhasználó értesítése
ellenőrzési lépés továbbvitele
a sikertelen feladat ügyféltámogatási vagy újrapróbálkozási folyamatba irányítása
Ez integrációs munka. A Studio továbbra is hasznos lehet a modellút teszteléséhez, de az éles üzemi folyamat az API-ba tartozik.
Biztonságos migrációs minta
Ne mozgasson egyszerre teljes munkafolyamatot az API-ba.
Használja ezt a sorrendet:
tesztelje a feladatot kézzel a Studióban
írja le a stabil modellt, promptformát, bemeneti fájlokat és elvárt eredményt
olvassa el az API modellek oldalt és a modellreferenciát
küldjön be egy generálást az Rivya API gyorskezdés alapján
csak akkor adja hozzá a Files API-t, ha a modell referenciamédiát igényel
csak akkor adjon hozzá webhookokat, ha az állapot rendszeres lekérdezése már működik
csak akkor adja hozzá a Chat API-t, ha a terméknek Studio-n kívüli chatfordulókra van szüksége
Minden lépésnek könnyebbé kell tennie a munkafolyamat működtetését, nem csak automatizáltabbá.
Mikor maradjon a Studióban
Maradjon a Studióban, amikor a feladatnak még erre van szüksége:
szubjektív ellenőrzés
promptformálás
vizuális összehasonlítás
modellfeltárás
mentett kreatív előzmények
emberi döntés arról, hogy a következő lépés kép, videó, hang vagy Chat legyen-e
Ez nem gyengeség. A Studio erre a szakaszra készült.
Mikor váltson API-ra
Váltson API-ra, amikor:
ugyanaz a feladat gyakran ismétlődik
a bemenet strukturálható
a modell ismert
az alkalmazásnak saját UI-ból kell feladatokat létrehoznia
az állapot, hibák és kreditek világosan kezelhetők
az állapotlekérdezés vagy a webhookok illenek a termék háttérrendszeréhez
Az API akkor a legerősebb, amikor egy már megértett Rivya munkafolyamatot megbízható termékműveletté alakít.
Következő lépés a Rivyában
Használja a Developers oldalt az API felület előnézetéhez.
Olvassa el a Rivya API gyorskezdés útmutatót éles üzemi kód írása előtt.
Olvassa el az API-hitelesítés oldalt API-kulcs tárolása előtt.
Olvassa el a Multimodális AI-munkafolyamat építése a Rivya API-val cikket, ha a következő kérdés a modellek, fájlok, chat és webhookok összekapcsolása.
Használja a Munka mozgatása a Rivya Chat, Image, Video és Audio között cikket, ha a projekt még embervezérelt Studio-munkába tartozik.
