API Credits
Forstå hvordan Rivya API-kald bruger konto-credits, saldokontroller, reserverede credits, refusion ved fejlede opgaver og credit-fejlsøgning.
Sidst gennemgået den 2026/05/10
Rivya API bruger den samme kreditbeholdning på kontoen som Studio.
Brug GET /api/v1/credits til at læse den aktuelle saldo for API-nøglens konto.
Endpoint
GET https://rivya.ai/api/v1/creditsPåkrævet header:
Authorization: Bearer rvya_sk_...Svar
{
"current_credits": 123
}Genereringsfakturering
Når du indsender en generering, kontrollerer Rivya, om kontoen har nok kreditter.
Ved billed-, video- og lydopgaver bliver kreditter normalt reserveret eller brugt, når opgaven starter. Svaret på genereringen omfatter:
reserved_creditsfinal_credits
final_credits kan forblive 0, mens jobbet stadig er queued eller processing.
Fejlede jobs
Hvis en opgave fejler under Rivyas eksisterende fejlregler, følger refusionshåndteringen den samme produktpolitik som Studio.
Brug Genereringsstatus til at bekræfte den endelige status og Fejlede opgaver og kreditrefusioner til at forstå produktets håndtering af fejl.
Almindelige kreditfejl
insufficient_credits: kontoen har ikke nok kreditterapi_key_invalid: API-nøglen kan ikke identificere en kontopublic_api_disabled: den offentlige API er midlertidigt deaktiveret