Læs hele svaret
Ved en mislykket status bevarer du HTTP-koden, headerne, fejlsvarets brødtekst og anmodnings-ID'et, efter at hemmeligheder er fjernet. De adskiller en ugyldig anmodning fra afvist adgang eller et midlertidigt problem.
Vis ikke et råt tjenestesvar som den eneste brugermeddelelse: forklar handlingen, og bevar de diagnostiske oplysninger til en operatør.
Undersøg et mislykket svar
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":[]}'Klassificér fejlen
- 4xx kræver normalt at en nøgle, input eller adgang korrigeres.
- 429 kræver at grænsevinduet respekteres og at aggressive nye forsøg undgås.
- 5xx-fejl og netværksfejl kræver et begrænset antal nye forsøg med eksponentiel ventetid og tilfældig variation.
Prøv sikkert igen
Prøv kun forbigående fejl igen, og kun hvis operationen er idempotent i dit produkt. Ved generering skal du bevare et klientanmodnings-ID for at forhindre dobbeltdebitering eller et duplikeret artefakt.
Ved streaming skal du skelne mellem en fejl før det første delta og en afbrydelse efter delvist output: sidstnævnte kan ikke i det skjulte erstattes med et nyt svar.