cicora.ai
API-määritysLuotettavuus

Virheet ja virheenkorjaus

Rakenna käsittely HTTP-tilan, rakenteisen virhesisällön ja pyyntötunnuksen varaan viestitekstin sijasta.

Integraatio-opas: valitse parametrit ja saatavilla olevat ominaisuudet ympäristösi tilin API-asetuksista ja malliluettelosta.

Lue koko vastaus

Säilytä epäonnistuneesta tilasta HTTP-koodi, otsakkeet, virhesisältö ja pyyntötunnus salaisuuksien poistamisen jälkeen. Ne erottavat virheellisen pyynnön käyttöoikeuden hylkäyksestä tai tilapäisestä ongelmasta.

Älä näytä raakaa palveluvastausta ainoana käyttäjäviestinä: selitä toiminto ja säilytä samalla diagnostiikkatiedot operaattorille.

Tutki epäonnistunut vastaus
bash
curl --include --request POST https://cicora.ai/api/v1/chat/completions \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"model":"openai/gpt-5.6-sol","messages":[]}'

Luokittele virhe

  • 4xx edellyttää yleensä avaimen, syötetietojen tai käyttöoikeuden korjaamista.
  • 429 edellyttää rajaikkunan noudattamista ja aggressiivisen uudelleenyrityksen välttämistä.
  • 5xx-virheet ja verkkovirheet edellyttävät rajattuja uudelleenyrityksiä, joissa käytetään eksponentiaalista viivettä ja satunnaisvaihtelua.

Yritä uudelleen turvallisesti

Yritä uudelleen vain tilapäisissä virheissä ja vain, jos toiminto on tuotteessasi idempotentti. Säilytä generoinnissa asiakkaan pyyntötunnus kaksoisveloituksen tai päällekkäisen artefaktin estämiseksi.

Erota suoratoistossa ennen ensimmäistä deltaa tapahtuva virhe osittaisen tulosteen jälkeisestä katkoksesta: jälkimmäistä ei voi korvata huomaamatta uudella vastauksella.