Der leichteste Fehler ist, Rivya API und Rivya Studio als konkurrierende Pfade zu behandeln.
Besser versteht man sie als zwei Phasen desselben Produkts. Studio ist der Ort, an dem Menschen visuell erkunden, wählen, prüfen und Arbeit fortsetzen. Die API ist der Ort, an dem ein stabiler Workflow Teil eines anderen Produkts, Skripts oder Backend-Prozesses wird.
Wenn du die API-Oberfläche noch kennenlernst, beginne mit What Is the Rivya API?. Diese Seite ist enger: Wie entscheidest du, ob eine konkrete Aufgabe in Studio oder in die API gehört?
Die Entscheidung In Einer Tabelle
| Frage | Nutze Studio, wenn ... | Nutze die API, wenn ... |
|---|---|---|
| Ist der Output noch explorativ? | ja | nein, der Workflow ist bereits wiederholbar |
| Muss eine Person Ergebnisse vergleichen? | ja | nur nachdem deine App Ergebnisse empfängt |
| Ist die Modellwahl stabil? | noch nicht | ja, oder aus der API-Modellliste gewählt |
| Braucht die Aufgabe Referenzmedien? | eine Person bereitet sie noch vor | deine App kann sie über Files API hochladen |
| Muss das Ergebnis ein anderes System aktualisieren? | noch nicht | ja, über Polling oder Webhooks |
| Muss Credit-Nutzung sichtbar bleiben? | ja, während des Testens | ja, aber über Account-Level-API-Controls |
Es geht nicht darum, welche Oberfläche fortgeschrittener ist. Es geht darum, ob die Aufgabe bereit für Automatisierung ist.
Nutze Studio, Solange Die Arbeit Sich Noch Ändert
Studio ist der richtige Ort, wenn die menschliche Entscheidung noch die Hauptarbeit ist.
Dazu gehört:
- zwischen Image-, Video-, Audio- oder Chat-Modellen wählen
- testen, ob eine Prompt-Richtung behalten werden sollte
- visuelle Ergebnisse nebeneinander vergleichen
- entscheiden, ob Referenzmedien helfen oder schaden
- gespeicherte History nutzen, um von einem früheren Ergebnis fortzufahren
Das gilt besonders für kreative Arbeit. Wenn der Brief nicht stabil ist, macht Automatisierung die Verwirrung meistens schneller, nicht kleiner.
Nutze Die API, Wenn Der Workflow Wiederholbar Ist
Die API wird der bessere Pfad, wenn Inputs und nächste Schritte vorhersehbar genug sind.
Gute Signale:
- dein Produkt kennt bereits das Modell oder die Modellkategorie, die es braucht
- Nutzereingaben lassen sich in einen stabilen Request Body abbilden
- ein Backend-Job kann Status pollen, ohne dass jemand auf einen Bildschirm schaut
- ein Webhook kann den richtigen Datensatz aktualisieren, wenn eine Aufgabe fertig ist
- die App kann Credit-Nutzung dem Team oder Account Owner erklären
An diesem Punkt kann Studio für jeden Durchlauf der langsamere Pfad werden. Die API lässt dein Produkt die Aufgabe direkt starten.
Eine Praktische Grenze: Discovery Versus Integration
Nutze Studio für Discovery.
Nutze die API für Integration.
Discovery bedeutet:
- "Welches Modell sollten wir verwenden?"
- "Welche Prompt-Form funktioniert?"
- "Verbessern Referenzmedien diese Aufgabe?"
- "Ist die Output-Qualität gut genug für diesen Use Case?"
Integration bedeutet:
- "Diese Nutzeraktion soll einen Generation Job erstellen."
- "Dieser Job soll idempotent erneut versucht werden."
- "Diese Datei soll hochgeladen und an eine Modellanfrage angehängt werden."
- "Diese abgeschlossene Aufgabe soll unseren Produktdatensatz aktualisieren."
Diese Grenze verhindert, dass die API zu einer versteckten Experimentierfläche wird.
Wie Credits Die Entscheidung Beeinflussen Sollten
Studio- und API-Nutzung ziehen aus denselben Rivya Account Credits.
Das bedeutet, Credit-Verhalten sollte Teil des Produktdesigns sein, kein Nachgedanke.
Nutze zuerst Studio, wenn das Team die Kostenform noch lernen muss. Nutze die API, wenn die Aufgabe stabil genug ist, dass das Produkt erklären kann, wann Credits reserviert oder verbraucht werden können.
Für die aktuellen öffentlichen Regeln lies API Credits. Wenn ein Workflow zu teuer ist, um ihn dem Account Owner zu erklären, ist er noch nicht bereit für API-Automatisierung.
Wo Files Die Wahl Verändern
Referenzmedien sind oft der Punkt, an dem eine Integration ernster wird.
In Studio kann eine Person hochladen, prüfen, erneut versuchen und entscheiden, ob die Datei gut genug ist. In der API muss dein Produkt den Dateipfad bewusst über Files API behandeln.
Nutze Studio, wenn:
- Referenzbild, Video oder Audio noch menschliches Cleanup braucht
- das Team unsicher ist, welche Referenz das Modell führen sollte
- die File-Regeln den Nutzern noch nicht klar erklärt werden können
Nutze die API, wenn:
- die App die Datei sicher einsammeln kann
- die Referenzanforderungen des Modells bekannt sind
- die Datei vor der Generation- oder Chat-Anfrage hochgeladen werden kann
- Fehler in deinem eigenen Produkt angezeigt werden können, ohne zu verstecken, was passiert ist
Files API ist eine nützliche Brücke, entfernt aber nicht die Notwendigkeit, die File Experience zu gestalten.
Wo Chat Die Wahl Verändert
Chat kann auf beide Seiten gehören.
Nutze Rivya Chat direkt, wenn eine Person erkundet, schreibt, prüft oder entscheidet.
Nutze Chat API, wenn der Chat Turn in deinem eigenen Produkt oder Server-Workflow leben muss. Das kann non-streaming Turns, optionales SSE streaming, API-erstellte Sessions und unterstützte Datei-Anhänge umfassen.
Die Kernfrage ist, wo die Konversation leben soll. Wenn die Konversation Teil der Rivya-Arbeit ist, nutze Rivya. Wenn die Konversation Teil deiner Produkterfahrung ist, nutze die API.
Wann Webhooks Ein Signal Sind
Wenn dein Workflow API Webhooks braucht, ist er wahrscheinlich über die manuelle Studio-Phase hinaus.
Webhooks sind nützlich, wenn ein anderes System auf abgeschlossene Generation Tasks reagieren muss:
- ein Asset als bereit markieren
- einen Nutzer benachrichtigen
- einen Review-Schritt voranbringen
- eine fehlgeschlagene Aufgabe in Support- oder Retry-Logik überführen
Das ist Integrationsarbeit. Studio kann weiterhin nützlich sein, um den Modellpfad zu testen, aber die Produktionsschleife gehört in die API.
Ein Sicheres Migrationsmuster
Verschiebe nicht einen ganzen Workflow auf einmal in die API.
Nutze diese Sequenz:
- teste die Aufgabe manuell in Studio
- notiere das stabile Modell, die Prompt-Form, Input Files und das erwartete Ergebnis
- lies API Models und die Modellreferenz
- reiche eine Generation über API Quickstart ein
- füge Files API nur hinzu, wenn das Modell Referenzmedien braucht
- füge Webhooks erst hinzu, nachdem Polling funktioniert
- füge Chat API nur hinzu, wenn das Produkt Chat Turns außerhalb von Studio braucht
Jeder Schritt sollte den Workflow leichter betreibbar machen, nicht nur stärker automatisiert.
Wann Du In Studio Bleiben Solltest
Bleibe in Studio, wenn die Aufgabe noch Folgendes braucht:
- subjektives Review
- Prompt-Formung
- visuellen Vergleich
- Modellerkundung
- gespeicherte kreative History
- eine Person, die entscheidet, ob der nächste Schritt Image, Video, Audio oder Chat ist
Das ist keine Schwäche. Studio ist für diese Phase gebaut.
Wann Du Zur API Wechseln Solltest
Wechsle zur API, wenn:
- dieselbe Aufgabe oft wiederholt wird
- der Input strukturiert werden kann
- das Modell bekannt ist
- die App Aufgaben aus der eigenen UI erstellen muss
- Status, Fehler und Credits klar behandelt werden können
- Polling oder Webhooks zum Backend deines Produkts passen
Die API ist am stärksten, wenn sie einen bereits verstandenen Rivya-Workflow in eine zuverlässige Produktaktion verwandelt.
Nächster Schritt In Rivya
- Nutze Developers, um die API-Oberfläche vorzuschauen.
- Lies Rivya API Quickstart, bevor du Production Code schreibst.
- Lies API Authentication, bevor du einen API Key speicherst.
- Lies How to Build a Multimodal AI Workflow with Rivya API, wenn die nächste Frage ist, wie Modelle, Files, Chat und Webhooks verbunden werden.
- Nutze Moving Work Across Rivya Chat, Image, Video, Audio, wenn das Projekt noch in menschengeführte Studio-Arbeit gehört.
