Hantera Rivya API:s offentliga felkoder, HTTP-statusvärden, rate limits, idempotenskonflikter och beslut om omförsök.

Rivya API returnerar stabila offentliga felkoder i JSON. Behandla värdet error.code som integrationskontraktet.

Felformat

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

Behåll requestId i dina loggar när du ber Rivya-supporten undersöka en misslyckad API-begäran.

Stabila felkoder

Code	HTTP status	Betydelse	Föreslagen åtgärd
`public_api_disabled`	503	Public API-anrop är tillfälligt inaktiverade.	Försök igen senare eller använd Studio manuellt.
`api_key_missing`	401	Begäran innehöll ingen Bearer API-nyckel.	Skicka `Authorization: Bearer rvya_sk_...`.
`api_key_invalid`	401	Nyckeln kan inte verifieras.	Kontrollera nyckeln och rotera den vid behov.
`api_key_revoked`	401	Nyckeln har återkallats i Settings.	Skapa en ny nyckel.
`api_key_expired`	401	Nyckeln är inte längre giltig.	Skapa en ny nyckel.
`api_scope_denied`	403	Nyckeln saknar nödvändig scope.	Skapa en nyckel med den scope som behövs.
`rate_limited`	429	För många begäranden i det aktuella fönstret.	Backa och försök igen senare.
`validation_failed`	400	Body, modell, prompt eller params är ogiltiga.	Jämför din body med modellreferensen.
`not_found`	404	Den begärda uppgiften finns inte eller ägs inte av kontot.	Kontrollera det offentliga uppgifts-ID:t och kontogränsen.
`webhook_url_rejected`	400	Webhook-endpointens URL är inte tillåten.	Använd en offentlig HTTPS-URL utan credentials, fragment, localhost eller privata nätverksadresser.
`chat_model_not_supported`	400	Den valda modellen är inte tillgänglig för Chat API.	Läs `/api/v1/models` och välj en tillgänglig chattmodell.
`chat_session_conflict`	409	Chattsessionen kan inte användas för den här begäran.	Använd en API-skapad session som ägs av samma konto och modell.
`chat_attachment_not_supported`	400	Chattbilagan stöds inte.	Ladda upp en bild via Files API och skicka dess `file_id`.
`idempotency_conflict`	409	Samma idempotensnyckel återanvändes med annan indata.	Använd en ny nyckel eller skicka exakt samma body igen.
`insufficient_credits`	402	Kontot har inte tillräckligt med credits.	Lägg till credits eller välj en begäran med lägre kostnad.
`internal_error`	500	Begäran kunde inte slutföras.	Försök igen med idempotens eller kontakta support med `requestId`.

Rate limits

Rivya tillämpar applikationsnivåns Public API-rate limits per API-nyckel. Standardgränsen i produktion konfigureras med PUBLIC_API_RATE_LIMIT_PER_MINUTE.

När du får rate_limited, använd exponentiell backoff. Försök inte igen i en tät loop.

Idempotenta retries

Skicka Idempotency-Key med varje produktionsanrop till POST /api/v1/generations och POST /api/v1/chat/completions.

Rekommenderat mönster:

generera en unik nyckel per logisk genereringsbegäran
återanvänd samma nyckel endast när du försöker igen med samma body
spara det returnerade offentliga uppgifts-ID:t med din egen jobbrad
för Chat API, spara det returnerade session_id när du vill fortsätta samma konversation
återanvänd inte en nyckel för en annan modell, prompt eller params

Om nätverket fallerar efter inskick, försök igen med samma body och samma Idempotency-Key. Rivya kan returnera det sparade offentliga svaret i stället för att skapa en duplicerad uppgift.

Beslut om omförsök

Försök igen med backoff för dessa:

public_api_disabled
rate_limited
internal_error
tillfälliga nätverksfel

Försök inte igen med dessa utan att ändra indata:

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-fel och gränser

Felformat

Stabila felkoder

Rate limits

Idempotenta retries

Beslut om omförsök

Relaterade sidor

Innehållsförteckning