Håndter offentlige Rivya API-feilkoder, HTTP-statusverdier, rate limits, idempotenskonflikter og retry-valg.

Rivya API returnerer stabile offentlige feilkoder i JSON. Behandle error.code-verdien som integrasjonskontrakten.

Feilformat

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

Behold requestId i loggene dine når du ber Rivya support undersøke en mislykket API-forespørsel.

Stabile feilkoder

Code	HTTP status	Betydning	Foreslått handling
`public_api_disabled`	503	Kall til den offentlige API-en er midlertidig deaktivert.	Prøv igjen senere eller bruk Studio manuelt.
`api_key_missing`	401	Forespørselen inkluderte ikke en Bearer API-nøkkel.	Send `Authorization: Bearer rvya_sk_...`.
`api_key_invalid`	401	Nøkkelen kan ikke verifiseres.	Sjekk nøkkelen og roter den ved behov.
`api_key_revoked`	401	Nøkkelen ble tilbakekalt i Innstillinger.	Opprett en ny nøkkel.
`api_key_expired`	401	Nøkkelen er ikke lenger gyldig.	Opprett en ny nøkkel.
`api_scope_denied`	403	Nøkkelen har ikke påkrevd scope.	Opprett en nøkkel med nødvendig scope.
`rate_limited`	429	For mange forespørsler i det nåværende vinduet.	Vent og prøv igjen senere.
`validation_failed`	400	Forespørselskropp, modell, ledetekst eller parametere er ugyldige.	Sammenlign forespørselskroppen med modellreferansen.
`not_found`	404	Den forespurte oppgaven finnes ikke eller eies ikke av kontoen.	Sjekk den offentlige oppgave-ID-en og kontogrensen.
`webhook_url_rejected`	400	URL-en til webhook-endepunktet er ikke tillatt.	Bruk en offentlig HTTPS-URL uten credentials, fragments, localhost eller private nettverksadresser.
`chat_model_not_supported`	400	Den valgte modellen er ikke tilgjengelig for Chat API.	Les `/api/v1/models` og velg en tilgjengelig chatmodell.
`chat_session_conflict`	409	Chatøkten kan ikke brukes for denne forespørselen.	Bruk en API-opprettet økt som eies av samme konto og modell.
`chat_attachment_not_supported`	400	Chatvedlegget støttes ikke.	Last opp et bilde via Files API og send med dets `file_id`.
`idempotency_conflict`	409	Den samme idempotensnøkkelen ble gjenbrukt med andre inndata.	Bruk en ny nøkkel eller send nøyaktig samme body på nytt.
`insufficient_credits`	402	Kontoen har ikke nok kreditter.	Legg til kreditter eller velg en forespørsel med lavere kostnad.
`internal_error`	500	Forespørselen kunne ikke fullføres.	Prøv igjen med idempotens eller kontakt support med `requestId`.

Rate limits

Rivya bruker frekvensgrenser for den offentlige API-en på applikasjonsnivå per API-nøkkel. Standardgrensen i produksjon konfigureres med PUBLIC_API_RATE_LIMIT_PER_MINUTE.

Når du mottar rate_limited, bruk eksponentiell backoff. Ikke prøv igjen i en tett løkke.

Idempotente retries

Send Idempotency-Key med hver produksjonsforespørsel til POST /api/v1/generations og POST /api/v1/chat/completions.

Anbefalt mønster:

generer en unik nøkkel per logiske genereringsforespørsel
bruk samme nøkkel bare når du prøver samme body på nytt
lagre den returnerte offentlige oppgave-ID-en sammen med din egen jobbpost
for Chat API, lagre den returnerte session_id når du vil fortsette samme samtale
ikke gjenbruk én nøkkel for en annen modell, ledetekst eller andre parametere

Hvis nettverket feiler etter innsending, prøv på nytt med samme body og samme Idempotency-Key. Rivya kan returnere den lagrede offentlige responsen i stedet for å opprette en duplikatoppgave.

Retry-valg

Prøv disse på nytt med backoff:

public_api_disabled
rate_limited
internal_error
midlertidige nettverksfeil

Ikke prøv disse på nytt uten å endre inndataene:

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-feil og begrensninger

Feilformat

Stabile feilkoder

Rate limits

Idempotente retries

Retry-valg

Relaterte sider

Innholdsfortegnelse