Dokumentacja Rivya AI

Przewodnik po cyklu życia zadań w Rivya

Zrozum status zadań Rivya, rezerwację punktów, wysyłkę do dostawcy, wywołania zwrotne, odpytywanie, historię, powiadomienia i błędy.

Ostatni przegląd: 2026/08/29

Użyj tego przewodnika, gdy chcesz zrozumieć, co dzieje się po przesłaniu zadania generowania obrazu, wideo albo audio w Rivya.

Wyjaśnia w jednym miejscu stany zadań, rezerwację punktów, ukończenie po stronie dostawcy, historię, powiadomienia i obsługę nieudanych zadań.

Rzeczywiste Stany Zadania

Obecny asynchroniczny cykl generowania używa czterech widocznych stanów:

  • WAITING

  • GENERATING

  • SUCCESS

  • FAILED

Stany te są zapisywane w ai_task i wykorzystywane w Studio, historii, panelu oraz powiadomieniach.

Co Się Dzieje Po Przesłaniu

1. Rivya waliduje żądanie

Zanim cokolwiek trafi do dostawcy, Rivya sprawdza:

  • czy model istnieje

  • model jest obecnie dostępny

  • czy bezpośrednie generowanie jest włączone dla tego modelu

  • czy wykonanie korzysta z zadania asynchronicznego

  • czy długość polecenia jest poprawna

  • czy parametry formularza są znormalizowane

  • czy pliki referencyjne pasują do tego, co akceptuje model

Niektóre udokumentowane modele mają dodatkowe reguły. Audio Isolation wymagał wcześniej przesłanego pliku audio i sprawdzenia czasu trwania, ale obecnie jest niedostępny; Rivya powinna odrzucić żądanie na etapie kontroli dostępności, bez tworzenia zadania, rezerwowania kredytów ani rozpoczynania procesu przesyłania.

2. Rivya tworzy rekord zadania

Rivya najpierw tworzy wpis ai_task ze statusem WAITING.

Rekord przechowuje model, kategorię, polecenie, parametry, zarezerwowane punkty, typ rozliczenia, a później wynik lub stan błędu.

3. Punkty są pobierane przed wysyłką do dostawcy

To ważne: przy generowaniu asynchronicznym Rivya pobiera punkty zadania przed wysłaniem go dalej.

Jeśli punktów jest za mało:

  • zadanie jest oznaczane jako nieudane

  • usługa upstream nigdy nie jest wywoływana

  • może zostać utworzone powiadomienie o niewystarczającej liczbie punktów

4. Tworzone jest zadanie dostawcy

Jeśli model jest dostępny, bezpośrednie generowanie jest włączone i kredyty wystarczają, Rivya wysyła zadanie do właściwej usługi i zapisuje zewnętrzny identyfikator.

W tym momencie status przechodzi na GENERATING.

Jak Rivya Poznaje Wynik

Rivya obsługuje dwie ścieżki ukończenia:

  • wywołanie zwrotne dostawcy w środowiskach z włączoną tą funkcją

  • odświeżanie i odpytywanie statusu, gdy wywołanie zwrotne nie jest dostępne

Ścieżka wywołania zwrotnego weryfikuje też podpis webhooka przed zakończeniem zadania.

Jeśli wywołanie zwrotne przychodzi, zanim wynik dostawcy jest gotowy, Rivya może odroczyć obsługę i ponownie sprawdzić status.

Ścieżka Sukcesu

Po sukcesie Rivya:

  • zapisuje URL-e wyników

  • ustawia status na SUCCESS

  • rozlicza zadanie

  • udostępnia wynik w historii generowania

  • tworzy powiadomienie o sukcesie generowania

Dlatego ukończony obraz albo wideo pozostaje widoczne po opuszczeniu strony.

Ścieżka Błędu

Po błędzie Rivya:

  • zapisuje komunikat błędu

  • ustawia status na FAILED

  • zwraca punkty, gdy błąd nastąpił po rezerwacji, która powinna zostać cofnięta

  • tworzy powiadomienie o nieudanym generowaniu do trwałego przeglądu

To różni się od tymczasowego toasta. Błąd staje się częścią rekordu konta.

Gdzie Widzisz Stan Zadania

To samo zadanie może pojawić się w kilku miejscach:

Ten wspólny stan jest jednym z powodów, dla których produkt wydaje się spójny, a nie jednorazowy.

Czym Różni Się Chat

Czat również podlega rozliczeniu, ale nie używa tego samego rekordu zadania asynchronicznego. Tury czatu są zapisywane jako:

  • sesje chatu

  • wiadomości chatu

Dla modeli czatu rozliczanych według tokenów Rivya może najpierw zarezerwować punkty, a następnie ustalić końcową kwotę po otrzymaniu danych o użyciu. Jeśli kwota końcowa jest niższa, różnica wraca na konto.

Szeroka reguła brzmi więc:

  • generowanie obrazu, wideo i audio używa ai_task

  • czat używa zapisanych sesji i rozliczenia na poziomie wiadomości

Czytaj Dalej

Checklista Stanu Zadania

Gdy generowanie jest mylące, wolne, nieudane albo brakujące, sprawdź:

  • Najpierw zidentyfikuj typ zadania: czat, obraz, wideo, audio lub czat wspierany narzędziem.

  • Potwierdź, że wybrany model jest dostępny; udokumentowana strona nie dowodzi, że zadanie może się rozpocząć.

  • Sprawdź, czy punkty zarezerwowano przed wysyłką do dostawcy, czy rozliczono po użyciu.

  • Poszukaj wywołania zwrotnego, wyniku odpytywania, elementu historii i powiadomienia, zanim uznasz wynik za utracony.

  • Oddziel błędy możliwe do poprawienia przez użytkownika od błędów dostawcy lub infrastruktury.

  • Potwierdź, czy nieudane zadanie powinno zwrócić punkty przed ponownym uruchomieniem tego samego polecenia.

Sprawdź Ponownie Przed Kolejnym Uruchomieniem

Sprawdź ponownie, gdy to samo polecenie wciąż zawodzi, zadanie zbyt długo pozostaje w toku, punkty wyglądają na zużyte bez wyniku lub zamierzasz uruchomić cięższy duplikat.