Förstå hur anrop till Rivya API använder kontots krediter, kontrollerar saldot, reserverar krediter, hanterar misslyckade uppgifter och felsöker krediter.

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.

API-rutt

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 generering kontrollerar Rivya att kontot har tillräckligt med krediter.

För bild-, video- och ljudjobb reserveras eller förbrukas krediter 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 krediter
api_key_invalid: API-nyckeln kan inte identifiera ett konto
public_api_disabled: det offentliga API:et är tillfälligt inaktiverat

API-krediter

API-rutt

Svar

Debitering för generering

Misslyckade jobb

Vanliga creditfel

Relaterade sidor

Innehållsförteckning