Käsittele Rivya API:n julkisia virhekoodeja, HTTP-statusarvoja, rate limit -rajoja, idempotenssiristiriitoja ja retry-päätöksiä.

Rivya API palauttaa vakaat julkiset virhekoodit JSON-muodossa. Käsittele error.code-arvoa integraatiosopimuksena.

Virheen muoto

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

Säilytä requestId lokeissasi, kun pyydät Rivyan tukea tutkimaan epäonnistunutta API-pyyntöä.

Vakaat virhekoodit

Code	HTTP-status	Merkitys	Suositeltu toiminta
`public_api_disabled`	503	Julkiset API-kutsut ovat väliaikaisesti poissa käytöstä.	Yritä myöhemmin uudelleen tai käytä Studiota manuaalisesti.
`api_key_missing`	401	Pyyntö ei sisältänyt Bearer API -avainta.	Lähetä `Authorization: Bearer rvya_sk_...`.
`api_key_invalid`	401	Avainta ei voi vahvistaa.	Tarkista avain ja kierrätä se tarvittaessa.
`api_key_revoked`	401	Avain peruttiin asetuksissa.	Luo uusi avain.
`api_key_expired`	401	Avain ei ole enää voimassa.	Luo uusi avain.
`api_scope_denied`	403	Avaimella ei ole vaadittua scope-oikeutta.	Luo avain, jossa on tarvittava scope-oikeus.
`rate_limited`	429	Nykyisessä aikaikkunassa on liian monta pyyntöä.	Hidasta ja yritä myöhemmin uudelleen.
`validation_failed`	400	Body, malli, prompti tai parametrit ovat virheellisiä.	Vertaa bodya malliviitteeseen.
`not_found`	404	Pyydettyä tehtävää ei ole olemassa tai se ei kuulu tilille.	Tarkista julkinen tehtävätunnus ja tiliraja.
`webhook_url_rejected`	400	Webhook-endpointin URL ei ole sallittu.	Käytä julkista HTTPS-URL-osoitetta ilman tunnuksia, fragmentteja, localhostia tai yksityisen verkon osoitteita.
`chat_model_not_supported`	400	Valittu malli ei ole saatavilla Chat API:lle.	Lue `/api/v1/models` ja valitse saatavilla oleva chat-malli.
`chat_session_conflict`	409	Chat-istuntoa ei voi käyttää tähän pyyntöön.	Käytä API:n luomaa istuntoa, joka kuuluu samalle tilille ja mallille.
`chat_attachment_not_supported`	400	Chat-liitettä ei tueta.	Lataa kuva Files API:n kautta ja anna sen `file_id`.
`idempotency_conflict`	409	Samaa idempotenssiavainta käytettiin uudelleen eri syötteellä.	Käytä uutta avainta tai lähetä täsmälleen sama body uudelleen.
`insufficient_credits`	402	Tilillä ei ole riittävästi krediittejä.	Lisää krediittejä tai valitse edullisempi pyyntö.
`internal_error`	500	Pyyntöä ei voitu suorittaa loppuun.	Yritä uudelleen idempotenssilla tai ota yhteyttä tukeen `requestId`-arvon kanssa.

Rate limit -rajat

Rivya soveltaa sovellustason Public API -rate limit -rajoja API-avainta kohden. Tuotannon oletusraja määritetään arvolla PUBLIC_API_RATE_LIMIT_PER_MINUTE.

Kun saat virheen rate_limited, käytä eksponentiaalista backoffia. Älä yritä uudelleen tiukassa silmukassa.

Idempotentit retryt

Lähetä Idempotency-Key jokaisen tuotannon POST /api/v1/generations- ja POST /api/v1/chat/completions -pyynnön mukana.

Suositeltu malli:

luo yksilöllinen avain jokaista loogista generointipyyntöä varten
käytä samaa avainta uudelleen vain, kun yrität uudelleen samaa bodya
tallenna palautettu julkinen tehtävätunnus omaan työrekisteriisi
Chat API:ssa tallenna palautettu session_id, kun haluat jatkaa samaa keskustelua
älä käytä yhtä avainta uudelleen eri mallille, promptille tai parametreille

Jos verkko epäonnistuu lähetyksen jälkeen, yritä uudelleen samalla bodylla ja samalla Idempotency-Key-arvolla. Rivya voi palauttaa tallennetun julkisen vastauksen kaksoistehtävän luomisen sijaan.

Retry-päätökset

Yritä näitä uudelleen backoffilla:

public_api_disabled
rate_limited
internal_error
tilapäiset verkkovirheet

Älä yritä näitä uudelleen muuttamatta syötettä:

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

API-virheet ja rajoitukset

Virheen muoto

Vakaat virhekoodit

Rate limit -rajat

Idempotentit retryt

Retry-päätökset

Liittyvät sivut

Sisällysluettelo