Rivya Journal
Auteur
Categorieën
Inhoudsopgave
Verder verkennen
Ga verder met gerelateerde gidsen, productnotities en workflow-uitsplitsingen van het Rivya-team.
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.
Deze vergelijking beschrijft het geïmplementeerde API-contract. De API-kant geldt alleen wanneer openbare API-toegang en elke genoemde functie, zoals webhooks, voor de deployment zijn ingeschakeld en voor het account beschikbaar zijn.
| 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 ingeschakelde 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.
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.
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.
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.
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.
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.
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.
Als je workflow API-webhooks nodig heeft, is die waarschijnlijk voorbij de handmatige Studio-fase. Controleer of webhooks voor de deployment zijn ingeschakeld voordat je ze in het productieontwerp opneemt.
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.
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 en webhooktoegang is ingeschakeld
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.
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.
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.
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.
