Kredyty API
Dowiedz się, jak wywołania Rivya API korzystają z kredytów konta, kontroli salda, zarezerwowanych kredytów, zwrotów za nieudane zadania i diagnostyki kredytów.
Ostatni przegląd: 2026/05/10
Rivya API używa tego samego portfela kredytów konta co Studio.
Użyj GET /api/v1/credits, aby odczytać bieżące saldo konta powiązanego z kluczem API.
Endpoint
GET https://rivya.ai/api/v1/creditsWymagany nagłówek:
Authorization: Bearer rvya_sk_...Odpowiedź
{
"current_credits": 123
}Rozliczanie Generowania
Gdy wysyłasz zadanie generowania, Rivya sprawdza, czy konto ma wystarczającą liczbę kredytów.
W przypadku zadań obrazu, wideo i audio kredyty są zwykle rezerwowane albo zużywane przy starcie zadania. Odpowiedź generowania zawiera:
reserved_creditsfinal_credits
final_credits może pozostać 0, dopóki zadanie nadal czeka w kolejce albo jest przetwarzane.
Nieudane Zadania
Jeśli zadanie kończy się niepowodzeniem zgodnie z obecnymi regułami awarii Rivya, obsługa zwrotu środków jest zgodna z tą samą polityką produktu co w Studio.
Użyj statusu generowania, aby potwierdzić stan końcowy, oraz nieudanych zadań i zwrotów kredytów, aby zrozumieć produktowy model awarii.
Typowe Błędy Kredytów
insufficient_credits: konto nie ma wystarczającej liczby kredytówapi_key_invalid: klucz API nie może zidentyfikować kontapublic_api_disabled: publiczne API jest tymczasowo wyłączone
Powiązane Strony
Chat API
Używaj Rivya Chat API do tur niestreamingowych albo SSE, sesji tworzonych przez API, załączników obrazów przez file_id i rozliczania kredytów na podstawie tokenów.
Błędy i limity API
Obsługuj publiczne kody błędów Rivya API, statusy HTTP, limity szybkości, konflikty idempotencji i decyzje o ponowieniu.