Najłatwiejszy błąd to traktowanie Rivya API i Rivya Studio jak konkurujących ze sobą ścieżek.
Lepiej rozumieć je jako dwa etapy tego samego produktu. Studio to miejsce, w którym ludzie eksplorują, wybierają, przeglądają i wizualnie kontynuują pracę. API to miejsce, w którym stabilny workflow staje się częścią innego produktu, skryptu albo procesu backendowego.
Jeśli nadal poznajesz powierzchnię API, zacznij od Czym jest Rivya API?. Ta strona jest węższa: jak zdecydować, czy konkretne zadanie należy do Studio, czy do API.
Decyzja w jednej tabeli
| Pytanie | Użyj Studio, gdy... | Użyj API, gdy... |
|---|---|---|
| Czy wynik nadal jest eksploracyjny? | tak | nie, workflow jest już powtarzalny |
| Czy człowiek musi porównywać wyniki? | tak | dopiero po tym, jak twoja aplikacja odbierze wyniki |
| Czy wybór modelu jest stabilny? | jeszcze nie | tak, albo model wybrano z listy modeli API |
| Czy zadanie potrzebuje mediów referencyjnych? | człowiek nadal je przygotowuje | twoja aplikacja może przesłać je przez Files API |
| Czy wynik musi aktualizować inny system? | jeszcze nie | tak, przez polling albo webhooks |
| Czy użycie kredytów musi pozostać widoczne? | tak, podczas testów | tak, ale przez kontrolki API na poziomie konta |
Nie chodzi o to, która powierzchnia jest bardziej zaawansowana. Chodzi o to, czy zadanie jest gotowe do automatyzacji.
Używaj Studio, gdy praca nadal się zmienia
Studio jest właściwym miejscem, gdy ludzka decyzja nadal jest główną pracą.
Obejmuje to:
- wybieranie między modelami obrazu, wideo, audio albo chatu
- testowanie, czy kierunek promptu warto zachować
- porównywanie wyników wizualnych obok siebie
- decydowanie, czy media referencyjne pomagają, czy przeszkadzają
- używanie zapisanej historii, aby kontynuować od wcześniejszego wyniku
Dotyczy to szczególnie pracy kreatywnej. Jeśli brief nie jest stabilny, automatyzowanie żądania zwykle przyspiesza zamieszanie, zamiast je zmniejszać.
Używaj API, gdy workflow jest powtarzalny
API staje się lepszą ścieżką, gdy wejścia i następne kroki są wystarczająco przewidywalne.
Dobre sygnały:
- twój produkt już wie, którego modelu albo kategorii modelu potrzebuje
- dane użytkownika można zmapować do stabilnego request body
- zadanie backendowe może sprawdzać status bez człowieka patrzącego na ekran
- webhook może zaktualizować właściwy rekord po zakończeniu zadania
- aplikacja potrafi wyjaśnić użycie kredytów zespołowi albo właścicielowi konta
Na tym etapie używanie Studio dla każdego uruchomienia może stać się wolniejszą ścieżką. API pozwala produktowi rozpocząć zadanie bezpośrednio.
Praktyczna granica: odkrywanie kontra integracja
Używaj Studio do odkrywania.
Używaj API do integracji.
Odkrywanie oznacza:
- „Którego modelu powinniśmy użyć?”
- „Jaki kształt promptu działa?”
- „Czy media referencyjne poprawiają to zadanie?”
- „Czy jakość wyniku jest wystarczająca dla tego przypadku użycia?”
Integracja oznacza:
- „Ta akcja użytkownika powinna utworzyć jedno zadanie generowania.”
- „To zadanie powinno być ponawiane idempotentnie.”
- „Ten plik powinien zostać przesłany i dołączony do żądania modelu.”
- „To ukończone zadanie powinno zaktualizować nasz rekord produktu.”
Ta granica chroni API przed zmianą w ukrytą powierzchnię eksperymentów.
Jak kredyty powinny wpływać na decyzję
Zarówno użycie Studio, jak i API korzysta z tych samych kredytów konta Rivya.
Oznacza to, że zachowanie kredytów powinno być częścią projektu produktu, a nie dopiskiem po fakcie.
Użyj najpierw Studio, gdy zespół nadal musi nauczyć się kształtu kosztów. Użyj API, gdy zadanie jest na tyle stabilne, że produkt potrafi wyjaśnić, kiedy kredyty mogą zostać zarezerwowane albo zużyte.
Aktualne publiczne zasady znajdziesz w Kredyty API. Jeśli workflow jest zbyt drogi, aby dało się go wyjaśnić właścicielowi konta, nie jest jeszcze gotowy do automatyzacji przez API.
Gdzie pliki zmieniają wybór
Media referencyjne często są miejscem, w którym integracja staje się poważniejsza.
W Studio człowiek może przesłać, obejrzeć, ponowić próbę i zdecydować, czy plik jest wystarczająco dobry. W API twój produkt musi celowo obsłużyć ścieżkę pliku przez Files API.
Użyj Studio, gdy:
- obraz, wideo albo audio referencyjne nadal wymaga ludzkiego oczyszczenia
- zespół nie jest pewien, która referencja powinna prowadzić model
- zasady plików nie są jeszcze jasne dla użytkownika
Użyj API, gdy:
- aplikacja może bezpiecznie zebrać plik
- wymagania referencyjne modelu są znane
- plik można przesłać przed żądaniem generowania albo chatu
- błędy można pokazać we własnym produkcie bez ukrywania tego, co się stało
Files API jest użytecznym mostem, ale nie usuwa potrzeby zaprojektowania doświadczenia pracy z plikiem.
Gdzie chat zmienia wybór
Chat może należeć do obu stron.
Używaj Rivya Chat bezpośrednio, gdy człowiek eksploruje, pisze, przegląda albo decyduje.
Używaj Chat API, gdy tura chatu musi żyć wewnątrz twojego produktu albo workflow serwera. Może to obejmować tury non-streaming, opcjonalny SSE streaming, sesje tworzone przez API i obsługiwane załączniki plików.
Kluczowe pytanie brzmi: gdzie rozmowa powinna żyć? Jeśli rozmowa jest częścią pracy w Rivya, użyj Rivya. Jeśli rozmowa jest częścią doświadczenia twojego produktu, użyj API.
Kiedy webhooks są sygnałem
Jeśli twój workflow potrzebuje API Webhooks, prawdopodobnie przekroczył już ręczny etap Studio.
Webhooks są użyteczne, gdy inny system musi zareagować na ukończone zadania generowania:
- oznaczyć zasób jako gotowy
- powiadomić użytkownika
- przesunąć krok przeglądu dalej
- przenieść nieudane zadanie do wsparcia albo logiki ponawiania
To jest praca integracyjna. Studio nadal może być użyteczne do testowania ścieżki modelu, ale pętla produkcyjna należy do API.
Bezpieczny wzorzec migracji
Nie przenoś całego workflow do API naraz.
Użyj tej sekwencji:
- przetestuj zadanie ręcznie w Studio
- zapisz stabilny model, kształt promptu, pliki wejściowe i oczekiwany wynik
- przeczytaj Modele API i referencję modelu
- wyślij jedno generowanie przez Szybki start Rivya API
- dodaj Files API tylko wtedy, gdy model wymaga mediów referencyjnych
- dodaj Webhooks dopiero po tym, jak polling działa
- dodaj Chat API tylko wtedy, gdy produkt potrzebuje tur chatu poza Studio
Każdy krok powinien ułatwiać operowanie workflow, a nie tylko zwiększać automatyzację.
Kiedy zostać w Studio
Zostań w Studio, gdy zadanie nadal potrzebuje:
- subiektywnego przeglądu
- kształtowania promptu
- porównania wizualnego
- eksploracji modeli
- zapisanej historii kreatywnej
- człowieka decydującego, czy następnym krokiem jest obraz, wideo, audio czy chat
To nie jest słabość. Studio jest zaprojektowane dla tego etapu.
Kiedy przejść do API
Przejdź do API, gdy:
- to samo zadanie często się powtarza
- wejście można ustrukturyzować
- model jest znany
- aplikacja musi tworzyć zadania z własnego UI
- status, błędy i kredyty można obsłużyć jasno
- polling albo webhooks pasują do backendu produktu
API jest najsilniejsze wtedy, gdy zmienia już zrozumiany workflow Rivya w niezawodną akcję produktu.
Następny krok w Rivya
- Użyj Developers, aby podejrzeć powierzchnię API.
- Przeczytaj Szybki start Rivya API, zanim napiszesz kod produkcyjny.
- Przeczytaj Uwierzytelnianie API, zanim zapiszesz klucz API.
- Przeczytaj Jak zbudować multimodalny workflow AI z Rivya API, jeśli następnym pytaniem jest połączenie modeli, plików, chatu i webhooks.
- Użyj Przenoszenie pracy między Rivya Chat, Image, Video, Audio, jeśli projekt nadal należy do pracy Studio prowadzonej przez człowieka.
