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 kredittsaldoen for kontoen 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 kreditter.
For bilde-, video- og lydjobber reserveres eller brukes kreditter 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 tilbakeføring av kreditter for feilhåndteringen på produktnivå.
Vanlige kredittfeil
insufficient_credits: kontoen har ikke nok kreditterapi_key_invalid: API-nøkkelen kan ikke identifisere en kontopublic_api_disabled: det offentlige API-et er midlertidig deaktivert