Rivya AI-dokumentation

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/credits

Nö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_credits
  • final_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 credits
  • api_key_invalid: API-nyckeln kan inte identifiera ett konto
  • public_api_disabled: det offentliga API:et är tillfälligt inaktiverat

Relaterade sidor

Innehållsförteckning