Den nemmeste fejl er at behandle Rivya API og Rivya Studio som konkurrerende veje.
De giver mere mening som to trin i det samme produkt. Studio er stedet, hvor mennesker udforsker, vælger, gennemgår og fortsætter arbejdet visuelt. API-et er stedet, hvor en stabil arbejdsgang bliver en del af et andet produkt, et script eller en proces på serversiden.
Denne sammenligning beskriver den implementerede API-kontrakt. API-siden gælder kun, når Public API-adgang og eventuelle nævnte funktioner, såsom webhooks, er aktiveret for installationen og tilgængelige for kontoen.
Hvis du stadig lærer API-overfladen at kende, så start med Hvad er Rivya API?. Denne side er mere snæver: hvordan du beslutter, om en specifik opgave hører hjemme i Studio eller i API'et.
Beslutningen i én tabel
| Spørgsmål | Brug Studio når... | Brug API'et når... |
|---|---|---|
| Er outputtet stadig undersøgende? | ja | nej, workflowet er allerede gentageligt |
| Skal en person sammenligne resultater? | ja | kun efter din app modtager resultater |
| Er modelvalget stabilt? | ikke endnu | ja, eller valgt fra API'ets modelliste |
| Har opgaven brug for referencemedier? | en person forbereder dem stadig | din app kan uploade dem gennem Fil-API-et |
| Skal resultatet opdatere et andet system? | ikke endnu | ja, gennem regelmæssige statusforespørgsler eller aktiverede webhooks |
| Skal creditforbruget forblive synligt? | ja, mens der testes | ja, men gennem API-kontroller på kontoniveau |
Det handler ikke om, hvilken flade der er mest avanceret. Det handler om, hvorvidt opgaven er klar til at blive automatiseret.
Brug Studio mens arbejdet stadig ændrer sig
Studio er det rigtige sted, når den menneskelige beslutning stadig er hovedarbejdet.
Det omfatter:
at vælge mellem billed-, video-, lyd- eller chatmodeller
at teste om en promptretning er værd at beholde
at sammenligne visuelle resultater side om side
at beslutte om referencemedier hjælper eller skader
at bruge gemt historik til at fortsætte fra et tidligere resultat
Det gælder især kreativt arbejde. Hvis briefen ikke er stabil, gør automatisering af anmodningen som regel forvirringen hurtigere snarere end mindre.
Brug API'et når workflowet er gentageligt
API-et er den bedre vej, når kildematerialet og næste trin er tilstrækkeligt forudsigelige.
Gode tegn:
dit produkt kender allerede den model eller modelkategori, det har brug for
brugerinput kan overføres til en stabil anmodningskrop
et job på serversiden kan kontrollere status med jævne mellemrum, uden at nogen følger med på en skærm
en aktiveret webhook kan opdatere den rette post, når en opgave er færdig
appen kan forklare creditforbrug til teamet eller kontoejeren
På det tidspunkt kan det blive den langsommere vej at bruge Studio til hver kørsel. API'et lader dit produkt starte opgaven direkte.
En praktisk grænse: opdagelse versus integration
Brug Studio til opdagelse.
Brug API'et til integration.
Opdagelse betyder:
"Hvilken model bør vi bruge?"
"Hvilken promptform virker?"
"Forbedrer referencemedier denne opgave?"
"Er outputkvaliteten god nok til denne brugssag?"
Integration betyder:
"Denne brugerhandling bør oprette ét genereringsjob."
"Denne opgave skal kunne prøves igen uden at oprette en dublet."
"Denne fil bør uploades og vedhæftes en modelanmodning."
"Denne færdige opgave bør opdatere vores produktpost."
Den grænse forhindrer API'et i at blive en skjult eksperimentflade.
Sådan bør kreditter påvirke beslutningen
Både Studio- og API-brug trækker fra de samme Rivya-kontocredits.
Det betyder, at creditadfærd bør være en del af produktdesignet, ikke en eftertanke.
Brug Studio først, når teamet stadig skal lære omkostningsformen at kende. Brug API-et, når opgaven er stabil nok til, at produktet kan forklare, hvornår kreditter kan reserveres eller bruges.
Læs API-kreditter for de aktuelle offentlige regler. Hvis en arbejdsgang er for dyr til at forklare kontoejeren, er den endnu ikke klar til automatisering via API-et.
Hvor filer ændrer valget
Referencemedier er ofte dér, hvor en integration bliver mere seriøs.
I Studio kan en person uploade, kontrollere, prøve igen og afgøre, om filen er god nok. I API-et skal dit produkt håndtere filforløbet bevidst gennem Fil-API-et.
Brug Studio når:
referencebillede, video eller lyd stadig kræver menneskelig oprydning
teamet er usikkert på, hvilken reference der skal guide modellen
filreglerne endnu ikke er klare for brugeren
Brug API'et når:
appen kan indsamle filen sikkert
modellens referencekrav er kendte
filen kan uploades før genererings- eller chatanmodningen
fejl kan vises i dit eget produkt uden at skjule, hvad der skete
Fil-API-et er en nyttig bro, men fjerner ikke behovet for at designe filoplevelsen.
Hvor Chat ændrer valget
Chat kan høre til på begge sider.
Brug Rivya Chat direkte, når en person udforsker, skriver, reviewer eller beslutter.
Brug Chat API, når chatbeskeden skal leve inde i dit eget produkt eller serverworkflow. Det kan omfatte ikke-streamede svar, valgfri SSE-streaming, API-oprettede sessioner og understøttede filvedhæftninger.
Nøglespørgsmålet er, hvor samtalen skal leve. Hvis samtalen er en del af Rivya-arbejde, så brug Rivya. Hvis samtalen er en del af din produktoplevelse, så brug API'et.
Når webhooks er et signal
Hvis din arbejdsgang kræver API Webhooks, er den sandsynligvis forbi det manuelle Studio-stadie. Bekræft, at webhooks er aktiveret for installationen, før du gør dem til en del af produktionsdesignet.
Webhooks er nyttige, når et andet system skal reagere på færdige genereringsopgaver:
markere et aktiv som klar
notificere en bruger
flytte et reviewtrin frem
flytte en fejlet opgave ind i support- eller retrylogik
Det er integrationsarbejde. Studio kan stadig være nyttigt til at teste modelvejen, men produktionsloopet hører hjemme i API'et.
Et sikkert migrationsmønster
Flyt ikke en hel arbejdsgang ind i API-et på én gang.
Brug denne sekvens:
test opgaven manuelt i Studio
skriv den stabile model, promptform, inputfiler og forventet resultat ned
læs API-modeller og modelreferencen
indsend én generation gennem API Quickstart
tilføj kun Fil-API-et, hvis modellen kræver referencemedier
tilføj først webhooks, når statusforespørgslerne fungerer, og webhookadgang er aktiveret
tilføj kun Chat API, hvis produktet har brug for chatsvar uden for Studio
Hvert skridt bør gøre workflowet lettere at drive, ikke bare mere automatiseret.
Hvornår du bør blive i Studio
Bliv i Studio, når opgaven stadig har brug for:
subjektiv gennemgang
promptformning
visuel sammenligning
modeludforskning
gemt kreativ historik
en person, der beslutter om næste skridt er billede, video, lyd eller chat
Det er ikke en svaghed. Studio er designet til det stadie.
Hvornår du bør flytte til API
Flyt til API når:
den samme opgave gentager sig ofte
inputtet kan struktureres
modellen er kendt
appen skal oprette opgaver fra sin egen UI
status, fejl og kreditter kan håndteres tydeligt
statusforespørgsler eller aktiverede webhooks passer til produktets serverside
API-et er stærkest, når det gør en allerede forstået Rivya-arbejdsgang til en pålidelig produkthandling.
Næste skridt i Rivya
Brug Developers til at forhåndsvise API-overfladen.
Læs Rivya API Quickstart, før du skriver produktionskode.
Læs API Authentication, før du gemmer en API-nøgle.
Læs Sådan bygger du en multimodal AI-arbejdsgang med Rivya API, hvis næste spørgsmål er, hvordan modeller, filer, chat og webhooks forbindes.
Brug Flyt arbejde mellem chat, billede, video og lyd i Rivya, hvis projektet stadig hører hjemme i menneskestyret Studio-arbejde.
