API-credits
Förstå hur Rivya API-anrop använder kontocredits, saldokontroller, reserverade credits, återbetalningar för misslyckade uppgifter och creditfelsökning.
Senast granskad 2026/05/10
Rivya API använder samma creditplånbok för kontot som Studio.
Använd GET /api/v1/credits för att läsa aktuellt saldo för API-nyckelns konto.
Endpoint
GET https://rivya.ai/api/v1/creditsNödvändig header:
Authorization: Bearer rvya_sk_...Svar
{
"current_credits": 123
}Debitering för generering
När du skickar in en generation kontrollerar Rivya om kontot har tillräckligt med credits.
För bild-, video- och ljudjobb reserveras eller förbrukas credits oftast när uppgiften startar. Genereringssvaret innehåller:
reserved_creditsfinal_credits
final_credits kan ligga kvar på 0 medan jobbet fortfarande är köat eller bearbetas.
Misslyckade jobb
Om en uppgift misslyckas enligt Rivyas befintliga felregler följer återbetalningshanteringen samma produktpolicy som Studio.
Använd genereringsstatus för att bekräfta slutstatus och misslyckade uppgifter och creditåterbetalningar för produktnivåns felmodell.
Vanliga creditfel
insufficient_credits: kontot har inte tillräckligt med creditsapi_key_invalid: API-nyckeln kan inte identifiera ett kontopublic_api_disabled: det offentliga API:et är tillfälligt inaktiverat