De makkelijkste fout is Rivya API en Rivya Studio behandelen als concurrerende paden.
Je kunt ze beter zien als twee fasen van hetzelfde product. Studio is waar mensen visueel verkennen, kiezen, beoordelen en werk voortzetten. De API is waar een stabiele workflow onderdeel wordt van een ander product, script of backendproces.
Als je het API-oppervlak nog leert kennen, begin dan met Wat is de Rivya API?. Deze pagina is smaller: hoe je beslist of een specifieke taak thuishoort in Studio of in de API.
De beslissing in één tabel
| Vraag | Gebruik Studio wanneer... | Gebruik de API wanneer... |
|---|---|---|
| Is het resultaat nog verkennend? | ja | nee, de workflow is al herhaalbaar |
| Moet een persoon resultaten vergelijken? | ja | alleen nadat je app resultaten ontvangt |
| Is de modelkeuze stabiel? | nog niet | ja, of gekozen uit de API-modellijst |
| Heeft de taak referentiemedia nodig? | een persoon bereidt ze nog voor | je app ze via Files API kan uploaden |
| Moet het resultaat een ander systeem bijwerken? | nog niet | ja, via polling of webhooks |
| Moet creditgebruik zichtbaar blijven? | ja, tijdens testen | ja, maar via accountniveau API-controles |
Dit gaat niet over welk oppervlak geavanceerder is. Het gaat erom of de taak klaar is om geautomatiseerd te worden.
Gebruik Studio zolang het werk nog verandert
Studio is de juiste plek wanneer de menselijke beslissing nog het hoofdwerk is.
Daaronder vallen:
- kiezen tussen beeld-, video-, audio- of chatmodellen
- testen of een promptrichting de moeite waard is om te behouden
- visuele resultaten naast elkaar vergelijken
- beslissen of referentiemedia helpen of juist storen
- opgeslagen geschiedenis gebruiken om verder te gaan vanuit een vorig resultaat
Dit geldt vooral voor creatief werk. Als de brief niet stabiel is, maakt automatisering van het verzoek de verwarring meestal sneller in plaats van kleiner.
Gebruik de API wanneer de workflow herhaalbaar is
De API wordt het betere pad wanneer de invoer en volgende stappen voorspelbaar genoeg zijn.
Goede signalen:
- je product weet al welk model of welke modelcategorie nodig is
- gebruikersinvoer kan worden omgezet naar een stabiele request body
- een backendtaak kan status pollen zonder dat iemand naar een scherm kijkt
- een webhook kan het juiste record bijwerken wanneer een taak klaar is
- de app kan creditgebruik uitleggen aan het team of de accounteigenaar
Op dat punt kan Studio voor elke uitvoering de tragere route worden. De API laat je product de taak direct starten.
Een praktische grens: ontdekking versus integratie
Gebruik Studio voor ontdekking.
Gebruik de API voor integratie.
Ontdekking betekent:
- "Welk model moeten we gebruiken?"
- "Welke promptvorm werkt?"
- "Verbetert referentiemedia deze taak?"
- "Is de resultaatkwaliteit goed genoeg voor deze toepassing?"
Integratie betekent:
- "Deze gebruikersactie moet één generatietaak maken."
- "Deze taak moet idempotent opnieuw geprobeerd worden."
- "Dit bestand moet worden geüpload en aan een modelaanvraag gekoppeld."
- "Deze voltooide taak moet ons productrecord bijwerken."
Die grens voorkomt dat de API een verborgen experimenteeroppervlak wordt.
Hoe credits de beslissing moeten beïnvloeden
Zowel Studio- als API-gebruik putten uit dezelfde Rivya-accountcredits.
Dat betekent dat creditgedrag onderdeel moet zijn van het productontwerp, geen nagedachte.
Gebruik eerst Studio wanneer het team de kostenvorm nog moet leren. Gebruik de API wanneer de taak stabiel genoeg is dat het product kan uitleggen wanneer credits kunnen worden gereserveerd of verbruikt.
Lees voor de huidige publieke regels API-credits. Als een workflow te duur is om aan de accounteigenaar uit te leggen, is die nog niet klaar voor API-automatisering.
Waar bestanden de keuze veranderen
Referentiemedia zijn vaak waar een integratie serieuzer wordt.
In Studio kan een persoon uploaden, inspecteren, opnieuw proberen en beslissen of het bestand goed genoeg is. In de API moet je product het bestandspad bewust afhandelen via Files API.
Gebruik Studio wanneer:
- het referentiebeeld, de referentievideo of audio nog menselijke opschoning nodig heeft
- het team niet zeker weet welke referentie het model moet sturen
- de bestandsregels nog niet duidelijk zijn voor de gebruiker
Gebruik de API wanneer:
- de app het bestand veilig kan verzamelen
- de referentievereisten van het model bekend zijn
- het bestand vóór de generatie- of chatrequest kan worden geüpload
- fouten in je eigen product kunnen worden getoond zonder te verhullen wat er gebeurde
Files API is een nuttige brug, maar het neemt de noodzaak niet weg om de bestandservaring te ontwerpen.
Waar Chat de keuze verandert
Chat kan aan beide kanten thuishoren.
Gebruik Rivya Chat direct wanneer een persoon verkent, schrijft, beoordeelt of beslist.
Gebruik Chat API wanneer de chatbeurt in je eigen product of serverworkflow moet leven. Dat kan non-streaming beurten, optionele SSE-streaming, API-aangemaakte sessies en ondersteunde bestandsbijlagen omvatten.
De kernvraag is waar het gesprek moet leven. Als het gesprek deel is van Rivya-werk, gebruik Rivya. Als het gesprek deel is van je productervaring, gebruik de API.
Wanneer webhooks een signaal zijn
Als je workflow API-webhooks nodig heeft, is die waarschijnlijk voorbij de handmatige Studio-fase.
Webhooks zijn nuttig wanneer een ander systeem moet reageren op voltooide generatietaken:
- een asset als klaar markeren
- een gebruiker informeren
- een beoordelingsstap vooruitzetten
- een mislukte taak naar support of herhaallogica verplaatsen
Dat is integratiewerk. Studio kan nog steeds nuttig zijn om het modelpad te testen, maar de productielus hoort in de API.
Een veilig migratiepatroon
Verplaats niet een hele workflow in één keer naar de API.
Gebruik deze volgorde:
- test de taak handmatig in Studio
- schrijf het stabiele model, de promptvorm, invoerbestanden en verwachte uitkomst op
- lees API-modellen en de modelreferentie
- dien één generatie in via Rivya API-snelstart
- voeg Files API alleen toe als het model referentiemedia vereist
- voeg Webhooks pas toe nadat polling werkt
- voeg Chat API alleen toe als het product chatbeurten buiten Studio nodig heeft
Elke stap moet de workflow makkelijker te bedienen maken, niet alleen meer geautomatiseerd.
Wanneer je in Studio blijft
Blijf in Studio wanneer de taak nog dit nodig heeft:
- subjectieve beoordeling
- promptvorming
- visuele vergelijking
- modelverkenning
- opgeslagen creatieve geschiedenis
- een persoon die beslist of de volgende stap beeld, video, audio of chat is
Dat is geen zwakte. Studio is ontworpen voor die fase.
Wanneer je naar API verhuist
Verhuis naar API wanneer:
- dezelfde taak vaak terugkomt
- de invoer gestructureerd kan worden
- het model bekend is
- de app taken vanuit de eigen UI moet maken
- status, fouten en credits duidelijk kunnen worden afgehandeld
- polling of webhooks passen bij de backend van het product
De API is het sterkst wanneer die een al begrepen Rivya-workflow omzet in een betrouwbare productactie.
Volgende stap in Rivya
- Gebruik Developers om het API-oppervlak vooraf te bekijken.
- Lees Rivya API-snelstart voordat je productiecode schrijft.
- Lees API-authenticatie voordat je een API key opslaat.
- Lees Een multimodale AI-workflow bouwen met Rivya API als de volgende vraag is hoe je modellen, bestanden, chat en webhooks verbindt.
- Gebruik Werk verplaatsen tussen Rivya Chat, Image, Video en Audio als het project nog thuishoort in mensgestuurd Studio-werk.
