API kreditek
Értsd meg, hogyan használják a Rivya API-hívások a fiókkrediteket, az egyenleg-ellenőrzést, a foglalt krediteket, a sikertelen feladatok visszatérítését és a kredithibák elhárítását.
Utoljára ellenőrizve: 2026/05/10
A Rivya API ugyanazt a fiókkredit-pénztárcát használja, mint a Studio.
Használd a GET /api/v1/credits endpointot az API-kulcshoz tartozó fiók aktuális egyenlegének lekéréséhez.
Endpoint
GET https://rivya.ai/api/v1/creditsSzükséges header:
Authorization: Bearer rvya_sk_...Válasz
{
"current_credits": 123
}Generálási számlázás
Generálás beküldésekor a Rivya ellenőrzi, hogy a fióknak van-e elég kreditje.
Kép-, videó- és hangfeladatoknál a kreditek általában a feladat indításakor kerülnek foglalásra vagy felhasználásra. A generálási válasz tartalmazza:
reserved_creditsfinal_credits
A final_credits értéke 0 maradhat, amíg a feladat még sorban áll vagy feldolgozás alatt van.
Sikertelen feladatok
Ha egy feladat a Rivya meglévő hibakezelési szabályai szerint sikertelen, a visszatérítés kezelése ugyanazt a termékszintű irányelvet követi, mint a Studióban.
A végső állapot megerősítéséhez használd a Generálási állapot oldalt, a termékszintű hibamodellhez pedig a Sikertelen feladatok és kredit-visszatérítések oldalt.
Gyakori kredithibák
insufficient_credits: a fióknak nincs elég kreditjeapi_key_invalid: az API-kulcs nem tud fiókot azonosítanipublic_api_disabled: a nyilvános API átmenetileg le van tiltva
Kapcsolódó oldalak
Chat API
Használd a Rivya Chat API-t nem streamelt vagy SSE fordulókhoz, API-val létrehozott munkamenetekhez, file_id kép-csatolmányokhoz és tokenalapú kreditelszámoláshoz.
API hibák és limitek
Kezeld a Rivya API nyilvános hibakódjait, HTTP státuszértékeit, rate limitjeit, idempotenciaütközéseit és újrapróbálkozási döntéseit.