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.
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, pollingon vagy webhookokon keresztül |
| 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 kreatív munkára. Ha a brief nem stabil, a kérés automatizálása általában gyorsabbá teszi a zavart, nem kisebbé.
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 request body-ba képezhető le
- egy backend feladat képes állapotot lekérdezni anélkül, hogy valaki képernyőt figyelne
- egy webhook frissíteni tudja a megfelelő rekordot, amikor egy feladat befejeződik
- 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 audio még emberi tisztí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 jelzés
Ha a munkafolyamatának API webhookok kell, valószínűleg túl van a kézi Studio-szakaszon.
A webhookok akkor hasznosak, amikor egy másik rendszernek reagálnia kell befejezett generálási feladatokra:
- asset késznek jelölése
- felhasználó értesítése
- ellenőrzési lépés továbbvitele
- sikertelen feladat support- vagy retry logikába mozgatása
Ez integrációs munka. A Studio továbbra is hasznos lehet a modellút teszteléséhez, de a produkciós kör 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 a polling 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 image, video, audio 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
- a polling vagy webhookok illenek a termék backendjé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 produkciós kód írása előtt.
- Olvassa el az API-hitelesítés oldalt API-kulcs tárolása előtt.
- Olvassa el a Hogyan építsen multimodális AI munkafolyamatot a Rivya API-val cikket, ha a következő kérdés az, hogyan kapcsolja össze a modelleket, fájlokat, chatet és webhookokat.
- 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.
