Developer guide
Virhekoodit
Toimet ja uudelleenyritussäännöt tilakoodien mukaan
Tällä sivulla on koottu yhdyskäytävän palauttamat tilakoodit ja niiden merkitykset sekä koodikohtaiset toimet.
Jos upstream palauttaa 4xx·5xx-koodin, se välitetään sellaisenaan. Muissa tapauksissa noudatetaan alla olevaa taulukkoa.
Lisäksi kuvataan kahden yhteensopivan määrityksen virherunkojen muodot, Anthropic-yhteensopivan error.type:n säännöt sekä konsolinäkymä, josta rajoitukset ja käyttö voidaan tarkistaa.
Tilakoodi
| Koodi | Merkitys | Toimet |
|---|---|---|
| 400 | Virheelliset pyyntöarvot. Anthropic-yhteensopivien mallien luettelon limit on alueen 1–1000 ulkopuolella tai tallennettua vastausta yritetään jatkaa kutsulla GET /responses/{responseId}?stream=true | Korjaa arvot sallitulle alueelle. Hae tallennetut vastaukset ilman stream-parametria. |
| 401 | Avain puuttuu tai avain on vanhentunut tai peruutettu | Tarkista avaimen tila API-avainten sivulta sekä otsakkeen nimi ja Bearer-etuliite. |
| 403 | Ei mallin käyttöoikeutta, käyttöraja ylitetty, krediitit loppuneet tai et ole äänen omistaja | error.message erottaa syyn. Tarkista määrät alla olevassa rajoitusten ja käytön tarkistamista käsittelevässä osiossa kuvatusta näkymästä. |
| 404 | Mallia ei ole tai siihen ei voi päästä tällä avaimella (mukaan lukien mallit, joiden tuki on päättynyt), polkua ei ole tai CleviDrive-tuotos on yli 3 päivän säilytysajan vanha | Tarkista ensin kutsuttavissa olevien mallien luettelo komennolla GET /models. Vertaa polkua API-kutsujen tekeminen -sivun taulukkoon. |
| 408 · 409 · 413 | Upstreamin aikakatkaisu, ruuhka tai pyynnön koon ylitys. Ääni- ja voice-polkujen aikaraja on 5 minuuttia ja pyynnön enimmäiskoko 28 MiB | Jos vastauksessa 409 on Retry-After, odota ilmoitettu aika. Pilko 413-pyyntö osiin. |
| 429 | Upstream-palveluntarjoaja on asettanut nopeusrajoituksen | Jos Retry-After ilmoitetaan, noudata sitä sellaisenaan. Muussa tapauksessa yritä uudelleen eksponentiaalisella backoffilla. |
| 5xx | Yhdyskäytävän tai upstreamin tilapäinen virhe (mukaan lukien 503) | Yritä uudelleen eksponentiaalisella backoffilla. Jos ongelma toistuu, ilmoita siitä ohjeiden ja yhteydenoton kautta ja liitä mukaan X-Request-Id. |
Uudelleenyrittäminen
Yhdyskäytävä ei luo omia 429-virheitä eikä yritä upstream-vastausta uudelleen huomaamatta tai lisää sitä jonoon.
Asiakas huolehtii odottamisesta ja uudelleenyrittämisestä.
| Koodi | Odotusaika | Sen jälkeen |
|---|---|---|
| 409 | Jos Retry-After on annettu, odota sen verran | Lähetä sama pyyntö uudelleen. |
| 429 | Jos Retry-After on annettu, odota sen verran; muussa tapauksessa käytä eksponentiaalista backoffia | Lähetä sama pyyntö uudelleen. |
| 5xx | Eksponentiaalinen backoff | Jos ongelma toistuu, ota yhteyttä. |
| 413 | Ei odotusta | Jaa pyyntö osiin. |
Virherunko
Virherungon muoto vaihtelee standardin mukaan. Upstream-virheistä välitetään vain viesti selkeytettynä, eikä pino- tai sisäisiä kenttiä välitetä.
OpenAI-yhteensopivan polun runko.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}Anthropic-yhteensopivan polun runko. error.type määräytyy tilakoodin perusteella.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| Tilakoodi | error.type |
|---|---|
| 400 | invalid_request_error |
| 401 | authentication_error |
| 403 | permission_error |
| 404 | not_found_error |
| 413 | request_too_large |
| 429 | rate_limit_error |
| 529 | overloaded_error |
| Muut koodit | api_error |
Rajojen ja käytön tarkistaminen
Rajojen arvot vaihtelevat työtilan mukaan. Tarkista 403-virheen syy error.message-kentästä ja katso sitten arvot alla olevista näkymistä.
| Tarkistettava asia | Konsolin näkymä |
|---|---|
| Työtilaani sovellettava raja | Yleiskatsauksen määritetty käyttöraja |
| Sopimuksen sallima alue ja saldo | Sopimus ja krediitit |
| Todellinen käyttö (kutsujen määrä malleittain ja avaimittain, arvioidut vähennettävät krediitit) | Käyttö |
| Avaimen tila (vanhentunut tai mitätöity) | API-avaimet |