API-credits
Forstå hvordan Rivya API-kall bruker kontocredits, saldosjekker, reserverte credits, refusjoner for mislykkede oppgaver og feilsøking av credits.
Sist gjennomgått 2026/05/10
Rivya API bruker den samme kontolommeboken for credits som Studio.
Bruk GET /api/v1/credits for å lese nåværende saldo for kontoen som API-nøkkelen tilhører.
Endepunkt
GET https://rivya.ai/api/v1/creditsPåkrevd header:
Authorization: Bearer rvya_sk_...Respons
{
"current_credits": 123
}Fakturering for generering
Når du sender inn en generering, sjekker Rivya om kontoen har nok credits.
For bilde-, video- og lydjobber reserveres eller brukes credits vanligvis når oppgaven starter. Genereringsresponsen inkluderer:
reserved_creditsfinal_credits
final_credits kan fortsatt være 0 mens jobben fortsatt er i kø eller behandles.
Mislykkede jobber
Hvis en oppgave feiler under Rivyas eksisterende feilregler, følger refusjonshåndteringen samme produktpolicy som Studio.
Bruk genereringsstatus for å bekrefte endelig status og mislykkede oppgaver og credit-refusjoner for feilmodellen på produktnivå.
Vanlige credit-feil
insufficient_credits: kontoen har ikke nok creditsapi_key_invalid: API-nøkkelen kan ikke identifisere en kontopublic_api_disabled: det offentlige API-et er midlertidig deaktivert