Credite API
Intelege cum folosesc apelurile Rivya API creditele contului, verificarile de sold, creditele rezervate, rambursarile pentru sarcini esuate si depanarea creditelor.
Ultima revizuire la 2026/05/10
Rivya API foloseste acelasi portofel de credite al contului ca Studio.
Foloseste 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_...Raspuns
{
"current_credits": 123
}Facturarea generarilor
Cand trimiti o generare, Rivya verifica daca acest cont are suficiente credite.
Pentru joburi de imagine, video si audio, creditele sunt de obicei rezervate sau consumate la pornirea sarcinii. Raspunsul generarii include:
reserved_creditsfinal_credits
final_credits poate ramane 0 cat timp jobul este inca in coada sau in procesare.
Joburi esuate
Daca o sarcina esueaza conform regulilor existente de esec ale Rivya, gestionarea rambursarii urmeaza aceeasi politica de produs ca Studio.
Foloseste Statusul generarii pentru a confirma statusul final si Sarcini esuate si rambursari de credite pentru modelul de esec 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
Chat API
Foloseste Rivya Chat API pentru ture non-streaming sau SSE, sesiuni create prin API, atasamente imagine file_id si decontare a creditelor pe baza de tokeni.
Erori si limite API
Gestioneaza codurile publice de eroare Rivya API, valorile de status HTTP, limitele de rata, conflictele de idempotenta si deciziile de retry.