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 służy do poszukiwania kierunku, wyboru, oceny i ręcznego kontynuowania pracy. API pozwala włączyć stabilny proces do innego produktu, skryptu lub zaplecza aplikacji.
Porównanie opisuje wdrożony kontrakt API. Strona API ma zastosowanie tylko wtedy, gdy dostęp do Public API i wskazane funkcje, takie jak webhooki, są włączone dla wdrożenia i dostępne dla konta.
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, proces 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 ma zaktualizować inny system? | jeszcze nie | tak, przez odpytywanie lub włączone webhooki |
| 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
sprawdzanie, czy kierunek polecenia 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 proces 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 przełożyć na stabilną treść żądania
zadanie backendowe może sprawdzać status bez człowieka patrzącego na ekran
włączony 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ć?”
„Jaka forma polecenia 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 proces jest zbyt drogi, aby dało się go jasno 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 czatu ma działać wewnątrz twojego produktu lub procesu serwerowego. Obejmuje to tury bez strumienia, opcjonalne przesyłanie przez SSE, sesje tworzone przez API i obsługiwane załączniki.
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 proces wymaga Webhooków API, prawdopodobnie wyszedł już poza ręczny etap Studio. Zanim uwzględnisz webhooki w architekturze produkcyjnej, potwierdź, że są włączone w danym wdrożeniu.
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 procesu do API naraz.
Użyj tej sekwencji:
przetestuj zadanie ręcznie w Studio
zapisz stabilny model, formę polecenia, 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 webhooki dopiero po uruchomieniu odpytywania statusu
dodaj Chat API tylko wtedy, gdy produkt potrzebuje tur chatu poza Studio
Każdy krok powinien ułatwiać obsługę procesu, a nie tylko zwiększać automatyzację.
Kiedy zostać w Studio
Zostań w Studio, gdy zadanie nadal potrzebuje:
subiektywnego przeglądu
formułowania polecenia
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
odpytywanie statusu lub webhooki pasują do zaplecza produktu
API najlepiej sprawdza się wtedy, gdy zmienia już zrozumiany proces 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 proces AI z Rivya API, jeśli kolejne pytanie dotyczy połączenia modeli, plików, czatu i webhooków.
Użyj Przenoszenie pracy między Rivya Chat, Image, Video, Audio, jeśli projekt nadal należy do pracy Studio prowadzonej przez człowieka.
