Rivya AI
Rivya Journal
Författare
Kategorier
Innehållsförteckning
Fortsätt utforska
Fortsätt med relaterade guider, produktanteckningar och arbetsflödesgenomgångar från Rivya-teamet.
Det enklaste misstaget är att behandla Rivya API och Rivya Studio som konkurrerande vägar.
De förstås bättre som två stadier av samma produkt. Studio är där människor utforskar, väljer, granskar och fortsätter arbetet visuellt. API:et är där ett stabilt arbetsflöde blir del av en annan produkt, ett script eller en backendprocess.
Jämförelsen beskriver det implementerade API-kontraktet. API-alternativet gäller bara när det offentliga API:et och de funktioner som nämns, exempelvis webhooks, är aktiverade för driftsmiljön och tillgängliga för kontot.
Om du fortfarande lär dig API-ytan, börja med Vad är Rivya API?. Den här sidan är smalare: hur du avgör om en specifik uppgift hör hemma i Studio eller i API:et.
| Fråga | Använd Studio när... | Använd API:et när... |
|---|---|---|
| Är resultatet fortfarande utforskande? | ja | nej, arbetsflödet är redan upprepbart |
| Behöver en person jämföra resultat? | ja | först efter att din app tar emot resultat |
| Är modellvalet stabilt? | inte ännu | ja, eller valt från API:ets modellista |
| Behöver uppgiften referensmedia? | en person förbereder det fortfarande | din app kan ladda upp det via Files API |
| Behöver resultatet uppdatera ett annat system? | inte ännu | ja, genom statuskontroller eller aktiverade webhooks |
| Behöver kreditanvändningen förbli synlig? | ja, medan ni testar | ja, men genom API-kontroller på kontonivå |
Det här handlar inte om vilken yta som är mer avancerad. Det handlar om om uppgiften är redo att automatiseras.
Studio är rätt plats när det mänskliga beslutet fortfarande är huvudarbetet.
Det innefattar:
att välja mellan bild-, video-, ljud- eller chattmodeller
att testa om en promptriktning är värd att behålla
att jämföra visuella resultat sida vid sida
att avgöra om referensmedia hjälper eller stör
att använda sparad historik för att fortsätta från ett tidigare resultat
Det gäller särskilt kreativt arbete. Om briefen inte är stabil gör automatisering av begäran oftast förvirringen snabbare snarare än mindre.
API:et blir den bättre vägen när indata och nästa steg är tillräckligt förutsägbara.
Bra tecken:
din produkt vet redan vilken modell eller modellkategori den behöver
användarindata kan mappas till en stabil begäran
ett backendjobb kan polla status utan att någon tittar på en skärm
en aktiverad webhook kan uppdatera rätt post när en uppgift är klar
appen kan förklara kreditanvändningen för teamet eller kontoägaren
Vid den punkten kan Studio för varje körning bli den långsammare vägen. API:et låter din produkt starta uppgiften direkt.
Använd Studio för utforskning.
Använd API:et för integration.
Utforskning betyder:
"Vilken modell ska vi använda?"
"Vilken promptform fungerar?"
"Förbättrar referensmedia den här uppgiften?"
"Är outputkvaliteten tillräckligt bra för detta användningsfall?"
Integration betyder:
"Den här användarhandlingen ska skapa ett genereringsjobb."
"Det här jobbet ska försöka igen idempotent."
"Den här filen ska laddas upp och kopplas till en modellbegäran."
"Den här slutförda uppgiften ska uppdatera vår produktpost."
Den gränsen hindrar API:et från att bli en dold experimentyta.
Både Studio- och API-användning drar från samma Rivya-kontocredits.
Det betyder att kredithanteringen bör vara en del av produktdesignen, inte en efterhandslösning.
Använd Studio först när teamet fortfarande behöver förstå kostnadsbilden. Använd API:et när uppgiften är så stabil att produkten kan förklara när krediter reserveras eller förbrukas.
För aktuella offentliga regler, läs API-krediter. Om ett arbetsflöde är för dyrt för att förklara för kontoägaren är det inte redo för API-automatisering ännu.
Referensmedia är ofta där en integration blir mer seriös.
I Studio kan en person ladda upp, inspektera, försöka igen och avgöra om filen är tillräckligt bra. I API:et behöver din produkt hantera filvägen medvetet genom Files API.
Använd Studio när:
referensbilden, videon eller ljudet fortfarande behöver mänsklig rensning
teamet är osäkert på vilken referens som ska styra modellen
filreglerna ännu inte är tydliga för användaren
Använd API:et när:
appen kan samla in filen säkert
modellens referenskrav är kända
filen kan laddas upp före genererings- eller chatbegäran
fel kan visas i din egen produkt utan att dölja vad som hände
Files API är en användbar brygga, men den tar inte bort behovet av att designa filupplevelsen.
Chat kan höra hemma på båda sidor.
Använd Rivya Chat direkt när en person utforskar, skriver, granskar eller beslutar.
Använd Chat API när chatturnen behöver leva i din egen produkt eller ditt serverarbetsflöde. Det kan innefatta non-streaming-turns, valfri SSE-streaming, API-skapade sessioner och stödda filbilagor.
Nyckelfrågan är var konversationen ska leva. Om konversationen är del av Rivya-arbete, använd Rivya. Om konversationen är del av din produktupplevelse, använd API:et.
Om ditt arbetsflöde behöver API Webhooks är det troligen förbi det manuella Studio-stadiet. Kontrollera att webhooks är aktiverade för driftsmiljön innan de blir en del av produktionsdesignen.
Webhooks är användbara när ett annat system behöver reagera på slutförda genereringsuppgifter:
markera en tillgång som klar
avisera en användare
flytta ett granskningssteg framåt
flytta en misslyckad uppgift till support eller omförsök-logik
Det är integrationsarbete. Studio kan fortfarande vara användbart för att testa modellvägen, men produktionsloopen hör hemma i API:et.
Flytta inte ett helt arbetsflöde till API:et på en gång.
Använd den här sekvensen:
testa uppgiften manuellt i Studio
skriv ner stabil modell, promptform, indatafiler och förväntat resultat
läs API-modeller och modellreferensen
skicka en generering genom API-snabbstart
lägg till Files API bara om modellen kräver referensmedia
lägg till webhooks först när statuskontrollerna fungerar och webhookåtkomst är aktiverad
lägg till Chat API bara om produkten behöver chatturns utanför Studio
Varje steg bör göra arbetsflödet lättare att driva, inte bara mer automatiserat.
Stanna i Studio när uppgiften fortfarande behöver:
subjektiv granskning
promptformning
visuell jämförelse
modellutforskning
sparad kreativ historik
en person som avgör om nästa steg är bild, video, ljud eller chatt
Det är ingen svaghet. Studio är designat för det stadiet.
Gå till API när:
samma uppgift återkommer ofta
indatan kan struktureras
modellen är känd
appen behöver skapa uppgifter från sitt eget UI
status, fel och krediter kan hanteras tydligt
statuskontroller, eller webhooks när de är aktiverade, passar produktens bakgrundstjänst
API:et är starkast när det gör ett redan förstått Rivya-arbetsflöde till en pålitlig produktåtgärd.
Använd Utvecklare för att förhandsgranska API-ytan.
Läs Rivya API-snabbstart innan du skriver produktionskod.
Läs API-autentisering innan du lagrar en API-nyckel.
Läs Så bygger du ett multimodalt AI-arbetsflöde med Rivya API om nästa fråga är hur du kopplar ihop modeller, filer, chatt och webhooks.
Använd Flytta arbete mellan Rivya Chat, Image, Video och Audio om projektet fortfarande hör hemma i mänskligt lett Studio-arbete.
