Wann Du Rivya API Statt Studio Nutzen Solltest

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, auswählen, prüfen und die Arbeit fortsetzen. Über die API wird ein stabiler Arbeitsablauf Teil eines anderen Produkts, Skripts oder Serverprozesses.

Wenn du die API-Oberfläche noch kennenlernst, beginne mit Was ist die Rivya API?. Diese Seite behandelt die speziellere Frage: Wie entscheidest du, ob eine konkrete Aufgabe in Studio oder in die API gehört?

Dieser Vergleich beschreibt den implementierten API-Vertrag. Die API-Seite gilt nur, wenn der Public-API-Zugriff und jede genannte Funktion, etwa Webhooks, für die Bereitstellung aktiviert und für das Konto verfügbar sind.

Die Entscheidung In Einer Tabelle

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 Richtung für die Anweisung beibehalten werden sollte

• visuelle Ergebnisse nebeneinander vergleichen

• entscheiden, ob Referenzmedien helfen oder schaden

• den gespeicherten Verlauf nutzen, um von einem früheren Ergebnis aus fortzufahren

Das gilt besonders für kreative Arbeit. Wenn das Briefing nicht stabil ist, beschleunigt die Automatisierung meist nur die Verwirrung.

Nutze die API, wenn der Arbeitsablauf wiederholbar ist

Die API ist der bessere Pfad, wenn Eingaben und nächste Schritte ausreichend vorhersehbar sind.

Gute Signale:

• dein Produkt kennt bereits das Modell oder die Modellkategorie, die es braucht

• Nutzereingaben lassen sich in einen stabilen Anfragekörper abbilden

• eine Aufgabe im Hintergrund kann den Zustand regelmäßig abfragen, ohne dass jemand auf einen Bildschirm schaut

• ein Webhook kann den richtigen Datensatz aktualisieren, wenn eine Aufgabe fertig ist

• die Anwendung kann den Credit-Verbrauch dem Team oder Kontoinhaber 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 Form der Anweisung funktioniert?“

• "Verbessern Referenzmedien diese Aufgabe?"

• „Ist die Ergebnisqualität gut genug für diesen Anwendungsfall?“

Integration bedeutet:

• „Diese Nutzeraktion soll eine Generierungsaufgabe erstellen.“

• „Diese Aufgabe 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 greifen auf dieselben Rivya-Konto-Credits zu.

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 Arbeitsablauf zu teuer ist, um ihn dem Kontoinhaber zu erklären, ist er noch nicht bereit für die API-Automatisierung.

Wie Dateien die Wahl beeinflussen

Referenzmedien sind oft der Punkt, an dem eine Integration ernster wird.

Im Studio kann eine Person eine Datei hochladen, prüfen, erneut versuchen und entscheiden, ob sie gut genug ist. In der API muss dein Produkt den Dateipfad bewusst über die Datei-API behandeln.

Nutze Studio, wenn:

• das Referenzbild, Video oder Audio noch manuell bereinigt werden muss

• 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

Die Datei-API ist eine nützliche Brücke, ersetzt aber nicht die bewusste Gestaltung des Dateierlebnisses.

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 die Chat API, wenn die Chatnachricht in deinem eigenen Produkt oder Server-Arbeitsablauf verarbeitet werden muss. Das kann vollständige Antworten, die optionale Übertragung per SSE, über die API erstellte Sitzungen und unterstützte Dateianhä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 Arbeitsablauf API Webhooks braucht, ist er wahrscheinlich über die manuelle Studio-Phase hinaus. Bestätige, dass Webhooks für die Bereitstellung aktiviert sind, bevor du sie in das Produktionsdesign einplanst.

Webhooks sind nützlich, wenn ein anderes System auf abgeschlossene Generierungsaufgaben reagieren muss:

• ein Medienergebnis als bereit markieren

• einen Nutzer benachrichtigen

• einen Prüfschritt voranbringen

• eine fehlgeschlagene Aufgabe an die Support- oder Wiederholungslogik übergeben

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 Arbeitsablauf auf einmal in die API.

Nutze diese Sequenz:

1. teste die Aufgabe manuell in Studio

2. notiere das stabile Modell, die Form der Anweisung, Eingabedateien und das erwartete Ergebnis

3. lies API-Modelle und die Modellreferenz

4. reiche eine Generation über API Quickstart ein

5. füge die Datei-API nur hinzu, wenn das Modell Referenzmedien braucht

6. füge Webhooks erst hinzu, wenn regelmäßige Statusabfragen funktionieren und der Webhook-Zugriff aktiviert ist

7. füge die Chat API nur hinzu, wenn das Produkt Chatnachrichten außerhalb von Studio verarbeiten muss

Jeder Schritt sollte den Arbeitsablauf leichter betreibbar machen, nicht nur stärker automatisieren.

Wann Du In Studio Bleiben Solltest

Bleibe in Studio, wenn die Aufgabe noch Folgendes braucht:

• subjektive Prüfung

• Ausarbeitung der Anweisung

• visuellen Vergleich

• Modellerkundung

• gespeicherter kreativer Verlauf

• 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

• die Eingabe strukturiert werden kann

• das Modell bekannt ist

• die App Aufgaben aus der eigenen UI erstellen muss

• Zustand, Fehler und Credits klar behandelt werden können

• regelmäßige Statusabfragen oder Webhooks zum Serverteil deines Produkts passen

Die API ist am stärksten, wenn sie einen bereits verstandenen Rivya-Arbeitsablauf in eine zuverlässige Produktaktion verwandelt.

Nächster Schritt In Rivya

• Nutze den Bereich Für Entwickler, um die API-Oberfläche anzusehen.

• Lies Rivya API Quickstart, bevor du Production Code schreibst.

• Lies API Authentication, bevor du einen API Key speicherst.

• Lies So erstellst du einen multimodalen KI-Arbeitsablauf mit der Rivya API, wenn die nächste Frage ist, wie Modelle, Dateien, Chat und Webhooks verbunden werden.

• Nutze Arbeit zwischen Rivya Chat, Bild, Video und Audio verschieben, wenn das Projekt noch in eine von Menschen geführte Studio-Arbeit gehört.