Kredity API
Pochopte, jak volání Rivya API používají kredity účtu, kontroly zůstatku, rezervované kredity, refundace neúspěšných úloh a řešení problémů s kredity.
Naposledy zkontrolováno 2026/05/10
Rivya API používá stejnou kreditní peněženku účtu jako Studio.
Použijte GET /api/v1/credits pro načtení aktuálního zůstatku účtu, ke kterému patří API klíč.
Koncový bod
GET https://rivya.ai/api/v1/creditsPožadovaný header:
Authorization: Bearer rvya_sk_...Odpověď
{
"current_credits": 123
}Účtování generování
Když odešlete generování, Rivya ověří, zda má účet dostatek kreditů.
U úloh pro obrázky, video a audio se kredity obvykle rezervují nebo spotřebují při spuštění úlohy. Odpověď generování obsahuje:
reserved_creditsfinal_credits
Dokud je úloha stále ve frontě nebo se zpracovává, final_credits může zůstat 0.
Neúspěšné úlohy
Pokud úloha selže podle stávajících pravidel selhání Rivya, refundace se řídí stejnou produktovou politikou jako ve Studiu.
Použijte Stav generování pro potvrzení finálního stavu a Neúspěšné úlohy a refundace kreditů pro produktový model selhání.
Běžné kreditní chyby
insufficient_credits: účet nemá dostatek kreditůapi_key_invalid: API klíč nedokáže identifikovat účetpublic_api_disabled: veřejné API je dočasně vypnuté
Související stránky
Chat API
Použijte Rivya Chat API pro nestreamované nebo SSE tahy, relace vytvořené přes API, obrazové přílohy file_id a kreditní vyrovnání podle tokenů.
Chyby a limity API
Pracujte s veřejnými chybovými kódy Rivya API, hodnotami HTTP statusu, limity rychlosti, konflikty idempotence a rozhodováním o opakování.