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í.

Rivya API vrací stabilní veřejné chybové kódy v JSON. Hodnotu error.code berte jako integrační smlouvu.

Tvar chyby

{
  "error": {
    "code": "api_key_missing",
    "message": "A valid Bearer API key is required.",
    "requestId": "req_..."
  }
}

Když žádáte podporu Rivya o prošetření neúspěšného API požadavku, ponechte requestId ve svých logách.

Stabilní chybové kódy

Kód	HTTP status	Význam	Doporučená akce
`public_api_disabled`	503	Volání Public API jsou dočasně vypnutá.	Zkuste to později znovu nebo použijte Studio ručně.
`api_key_missing`	401	Požadavek neobsahoval Bearer API klíč.	Odešlete `Authorization: Bearer rvya_sk_...`.
`api_key_invalid`	401	Klíč nelze ověřit.	Zkontrolujte klíč a v případě potřeby jej obměňte.
`api_key_revoked`	401	Klíč byl zrušen v Settings.	Vytvořte nový klíč.
`api_key_expired`	401	Klíč už není platný.	Vytvořte nový klíč.
`api_scope_denied`	403	Klíč nemá požadovaný scope.	Vytvořte klíč s potřebným scope.
`rate_limited`	429	V aktuálním okně je příliš mnoho požadavků.	Zpomalte a zkuste to později znovu.
`validation_failed`	400	Tělo, model, prompt nebo parametry nejsou platné.	Porovnejte své tělo požadavku s referencí modelu.
`not_found`	404	Požadovaná úloha neexistuje nebo nepatří účtu.	Zkontrolujte veřejné ID úlohy a hranici účtu.
`webhook_url_rejected`	400	URL endpointu webhooku není povolená.	Použijte veřejnou HTTPS URL bez přihlašovacích údajů, fragmentů, localhostu nebo adres privátní sítě.
`chat_model_not_supported`	400	Vybraný model není pro Chat API dostupný.	Přečtěte si `/api/v1/models` a zvolte dostupný chatový model.
`chat_session_conflict`	409	Chatovou relaci nelze pro tento požadavek použít.	Použijte relaci vytvořenou přes API, kterou vlastní stejný účet a model.
`chat_attachment_not_supported`	400	Chatová příloha není podporovaná.	Nahrajte obrázek přes Files API a předejte jeho `file_id`.
`idempotency_conflict`	409	Stejný idempotentní klíč byl znovu použit s jiným vstupem.	Použijte nový klíč nebo znovu odešlete přesně stejné tělo.
`insufficient_credits`	402	Účet nemá dostatek kreditů.	Doplňte kredity nebo zvolte levnější požadavek.
`internal_error`	500	Požadavek se nepodařilo dokončit.	Opakujte s idempotencí nebo kontaktujte podporu s `requestId`.

Limity rychlosti

Rivya uplatňuje aplikační limity rychlosti Public API pro každý API klíč. Výchozí produkční limit je nastaven pomocí PUBLIC_API_RATE_LIMIT_PER_MINUTE.

Když obdržíte rate_limited, použijte exponenciální backoff. Neopakujte požadavky v těsné smyčce.

Idempotentní opakování

Odesílejte Idempotency-Key s každým produkčním požadavkem POST /api/v1/generations a POST /api/v1/chat/completions.

Doporučený vzor:

vygenerujte jedinečný klíč pro každý logický požadavek na generování
stejný klíč znovu použijte jen při opakování stejného těla
uložte vrácené veřejné ID úlohy ke svému vlastnímu záznamu úlohy
u Chat API uložte vrácené session_id, pokud chcete pokračovat ve stejné konverzaci
nepoužívejte jeden klíč znovu pro jiný model, prompt nebo parametry

Pokud síť selže po odeslání, opakujte požadavek se stejným tělem a stejným Idempotency-Key. Rivya může vrátit uloženou veřejnou odpověď místo vytvoření duplicitní úlohy.

Rozhodování o opakování

Tyto chyby opakujte s backoffem:

public_api_disabled
rate_limited
internal_error
dočasná síťová selhání

Tyto chyby neopakujte bez změny vstupu:

api_key_invalid
api_key_revoked
api_scope_denied
validation_failed
webhook_url_rejected
chat_model_not_supported
chat_session_conflict
chat_attachment_not_supported
idempotency_conflict
insufficient_credits

Chyby a limity API

Tvar chyby

Stabilní chybové kódy

Limity rychlosti

Idempotentní opakování

Rozhodování o opakování

Související stránky

Obsah