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	Public API-kall 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 Settings.	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	Body, modell, prompt eller params er ugyldige.	Sammenlign bodyen din med modellreferansen.
`not_found`	404	Den forespurte oppgaven finnes ikke eller eies ikke av kontoen.	Sjekk offentlig task ID 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 credits.	Legg til credits 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 Public API-rate limits på applikasjonsnivå per API-nøkkel. Standard produksjonsgrense konfigureres av 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 task 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, prompt eller params

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 input:

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