API-credits
Begrijp hoe Rivya API-aanroepen accountcredits, saldochecks, gereserveerde credits, refunds voor mislukte taken en credittroubleshooting gebruiken.
Laatst beoordeeld op 2026/05/10
Rivya API gebruikt dezelfde accountcredit-wallet als Studio.
Gebruik GET /api/v1/credits om het huidige saldo te lezen voor het account van de API-sleutel.
Endpoint
GET https://rivya.ai/api/v1/creditsVereiste header:
Authorization: Bearer rvya_sk_...Response
{
"current_credits": 123
}Generatiebilling
Wanneer je een generatie indient, controleert Rivya of het account genoeg credits heeft.
Voor beeld-, video- en audiotaken worden credits meestal bij de taakstart gereserveerd of verbruikt. De generatieresponse bevat:
reserved_creditsfinal_credits
final_credits kan 0 blijven terwijl de taak nog queued is of wordt verwerkt.
Mislukte taken
Als een taak mislukt volgens Rivya's bestaande faalregels, volgt refundafhandeling hetzelfde productbeleid als Studio.
Gebruik Generatiestatus om de eindstatus te bevestigen en Mislukte taken en creditrefunds voor het productbrede faalmodel.
Veelvoorkomende creditfouten
insufficient_credits: het account heeft niet genoeg creditsapi_key_invalid: de API-sleutel kan geen account identificerenpublic_api_disabled: de publieke API is tijdelijk uitgeschakeld