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 credit-wallet 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 generation, kontrollerer Rivya, om kontoen har credits nok.
For billed-, video- og audiojobs bliver credits normalt reserveret eller forbrugt ved opgavestart. Genereringssvaret inkluderer:
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 endelig status og Fejlede opgaver og credit-refusioner til produktets fejlmodel.
Almindelige credit-fejl
insufficient_credits: kontoen har ikke credits nokapi_key_invalid: API-nøglen kan ikke identificere en kontopublic_api_disabled: den offentlige API er midlertidigt deaktiveret