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.
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.
Beslutet i en tabell
| 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 polling eller webhooks |
| Behöver credit-anvä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.
Använd Studio medan arbetet fortfarande ändras
Studio är rätt plats när det mänskliga beslutet fortfarande är huvudarbetet.
Det innefattar:
- att välja mellan image-, video-, audio- eller chatmodeller
- 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.
Använd API:et när arbetsflödet är upprepbart
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 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.
En praktisk gräns: discovery kontra integration
Använd Studio för discovery.
Använd API:et för integration.
Discovery 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.
Hur credits bör påverka beslutet
Både Studio- och API-användning drar från samma Rivya-kontocredits.
Det betyder att credit-beteende bör vara del av produktdesignen, inte en eftertanke.
Använd Studio först när teamet fortfarande behöver lära sig kostnadsformen. Använd API:et när uppgiften är så stabil att produkten kan förklara när credits kan reserveras eller förbrukas.
För aktuella publika regler, läs API Credits. 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.
Där filer ändrar valet
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.
Där chat ändrar valet
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.
När webhooks är en signal
Om ditt arbetsflöde behöver API Webhooks är det troligen förbi det manuella Studio-stadiet.
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.
Ett säkert migrationsmönster
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 efter att polling fungerar
- 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.
När du ska stanna i Studio
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 image, video, audio eller chat
Det är ingen svaghet. Studio är designat för det stadiet.
När du ska gå till API
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 credits kan hanteras tydligt
- polling eller webhooks passar produktens backend
API:et är starkast när det gör ett redan förstått Rivya-arbetsflöde till en pålitlig produktåtgärd.
Nästa steg i Rivya
- 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.
