Credite API
Înțelege cum folosesc apelurile către API-ul Rivya creditele contului, verificarea soldului, creditele rezervate, rambursările pentru sarcini eșuate și depanarea creditelor.
Ultima revizuire la 2026/05/10
API-ul Rivya folosește același portofel de credite al contului ca Studio.
Folosește GET /api/v1/credits pentru a citi soldul curent al contului asociat cheii API.
Endpoint
GET https://rivya.ai/api/v1/creditsHeader necesar:
Authorization: Bearer rvya_sk_...Răspuns
{
"current_credits": 123
}Facturarea generărilor
Când trimiți o generare, Rivya verifică dacă acest cont are suficiente credite.
Pentru sarcini de imagine, video și audio, creditele sunt de obicei rezervate sau consumate la pornire. Răspunsul generării include:
reserved_creditsfinal_credits
final_credits poate rămâne 0 cât timp sarcina este încă în coadă sau în curs de procesare.
Sarcini eșuate
Dacă o sarcină eșuează conform regulilor Rivya, rambursarea urmează aceeași politică de produs ca în Studio.
Folosește Starea generării pentru a confirma starea finală și Sarcini eșuate și rambursări de credite pentru regulile de eșec la nivel de produs.
Erori comune de credite
insufficient_credits: contul nu are suficiente crediteapi_key_invalid: cheia API nu poate identifica un contpublic_api_disabled: API-ul public este dezactivat temporar
Pagini asociate
Starea generării
Interoghează sarcinile de generare din API-ul Rivya după ID-ul public, citește stările `queued`, `processing`, `succeeded` și `failed` și folosește URL-urile rezultatului.
Erori și limite API
Gestionează codurile publice de eroare din API-ul Rivya, stările HTTP, limitele de rată, conflictele de idempotentă și deciziile de reîncercare.