Den nemmeste fejl er at behandle Rivya API og Rivya Studio som konkurrerende veje.
De forstås bedre som to stadier af det samme produkt. Studio er stedet, hvor mennesker udforsker, vælger, reviewer og fortsætter arbejdet visuelt. API'et er stedet, hvor et stabilt workflow bliver en del af et andet produkt, et script eller en backendproces.
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 Files API |
| Skal resultatet opdatere et andet system? | ikke endnu | ja, gennem polling eller 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 bliver den bedre vej, når input og næste skridt er forudsigelige nok.
Gode tegn:
- dit produkt kender allerede den model eller modelkategori, det har brug for
- brugerinput kan mappes til en stabil request body
- et backendjob kan poll'e status, uden at nogen ser på en skærm
- en webhook kan opdatere den rigtige 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."
- "Dette job bør kunne prøves igen idempotent."
- "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.
Hvordan credits bør 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 har brug for at lære omkostningsformen at kende. Brug API'et, når opgaven er stabil nok til, at produktet kan forklare, hvornår credits kan blive reserveret eller forbrugt.
Læs API Credits for de aktuelle offentlige regler. Hvis et workflow er for dyrt til at forklare kontoejeren, er det endnu ikke klar til API-automatisering.
Hvor filer ændrer valget
Referencemedier er ofte dér, hvor en integration bliver mere seriøs.
I Studio kan en person uploade, inspicere, prøve igen og beslutte, om filen er god nok. I API'et skal dit produkt håndtere filstien bevidst gennem Files API.
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
Files API er en nyttig bro, men den 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 dit workflow har brug for API Webhooks, er det sandsynligvis forbi det manuelle Studio-stadie.
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 et helt workflow 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 Models og modelreferencen
- indsend én generation gennem API Quickstart
- tilføj kun Files API, hvis modellen kræver referencemedier
- tilføj først Webhooks, når polling virker
- 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:
- subjektivt review
- 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 credits kan håndteres tydeligt
- polling eller webhooks passer til produktets backend
API'et er stærkest, når det gør et allerede forstået Rivya-workflow 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 et multimodalt AI-workflow med Rivya API, hvis næste spørgsmål er, hvordan modeller, filer, chat og webhooks forbindes.
- Brug Flyt arbejde på tværs af Rivya Chat, Image, Video, Audio, hvis projektet stadig hører hjemme i menneskestyret Studio-arbejde.
