API-krediitit
Ymmärrä, miten Rivya API -kutsut käyttävät tilin krediittejä, saldotarkistuksia, varattuja krediittejä, epäonnistuneiden tehtävien hyvityksiä ja krediittien vianetsintää.
Viimeksi tarkistettu 2026/05/10
Rivya API käyttää samaa tilin krediittilompakkoa kuin Studio.
Käytä GET /api/v1/credits -endpointtia API-avaimen tilin nykyisen saldon lukemiseen.
Endpoint
GET https://rivya.ai/api/v1/creditsVaadittu header:
Authorization: Bearer rvya_sk_...Vastaus
{
"current_credits": 123
}Generoinnin laskutus
Kun lähetät generoinnin, Rivya tarkistaa, onko tilillä riittävästi krediittejä.
Kuva-, video- ja audiotehtävissä krediitit yleensä varataan tai kulutetaan tehtävän alussa. Generoinnin vastaus sisältää:
reserved_creditsfinal_credits
final_credits voi pysyä arvossa 0, kun työ on vielä jonossa tai käsittelyssä.
Epäonnistuneet työt
Jos tehtävä epäonnistuu Rivyan nykyisten epäonnistumissääntöjen mukaisesti, hyvityskäsittely noudattaa samaa tuotekäytäntöä kuin Studiossa.
Käytä generoinnin tilaa lopullisen tilan varmistamiseen ja epäonnistuneet tehtävät ja krediittihyvitykset -sivua tuotetason epäonnistumismalliin.
Yleiset krediittivirheet
insufficient_credits: tilillä ei ole riittävästi krediittejäapi_key_invalid: API-avain ei voi tunnistaa tiliäpublic_api_disabled: julkinen API on väliaikaisesti poissa käytöstä
Liittyvät sivut
Chat API
Käytä Rivya Chat API:a ei-streamaaviin tai SSE-vuoroihin, API:n luomiin istuntoihin, file_id-kuvaliitteisiin ja token-pohjaiseen krediittien selvitykseen.
API-virheet ja rajoitukset
Käsittele Rivya API:n julkisia virhekoodeja, HTTP-statusarvoja, rate limit -rajoja, idempotenssiristiriitoja ja retry-päätöksiä.