Developer guide

Errore-kodea

Egoera-kodeen araberako jarduera eta berriro saiatzeko arauak

Orrialde honetan, atebideak itzultzen dituen egoera-kodeak eta haien esanahia azaltzen dira, baita kode bakoitzaren araberako jarduera ere.
Upstream-ek 4xx·5xx itzultzen badu, kode hori bere horretan birbidaltzen da; gainerako kasuetan, beheko taula aplikatzen da.
Bi bateragarritasun-zehaztapenen errore-gorputzen formatua eta Anthropic bateragarritasuneko error.type-ren arauak ere jaso dira, baita mugak eta erabilera egiaztatzeko kontsola-pantaila ere.

Egoera-kodea

KodeaEsanahiaJarduera
400Eskaeraren balio-errorea. Anthropic bateragarritasuneko modelo-zerrendaren limit 1~1000 tartetik kanpo dago, edo GET /responses/{responseId}?stream=true erabiliz gordetako erantzun bati berrekin nahi izan zaioDoitu balioa baimendutako tartera. Kontsultatu gordetako erantzuna stream gabe.
401Gakorik ez dago, edo gakoa iraungi edo baliogabetu egin daEgiaztatu gakoaren egoera API gakoen pantailan, eta berrikusi goiburuaren izena eta Bearer aurrizkia.
403Modelorako sarbide-baimenik ez, erabilera-muga gaindituta, kreditu nahikorik ez, edo ahotsaren jabea ez izateaerror.message mezuak arrazoia bereizten laguntzen du. Begiratu zenbakiak beheko mugak eta erabilera egiaztatzeko ataleko pantailan.
404Modeloa ez dago, edo ezin da gako honekin atzitu (euskarria amaitu zaien modeloak barne), bidea ez dago, edo 3 eguneko gordetze-epea gainditu duen CleviDrive irteera daEgiaztatu lehenik GET /models erabiliz dei daitezkeen modeloen zerrenda. Alderatu bidea API deitzeko orriko taularekin.
408 · 409 · 413Upstream-eko denbora-muga gainditzea, pilaketa edo eskaeraren tamaina gainditzea. Ahots- eta voice-bideen araberako denbora-muga 5 minutukoa da, eta eskaeraren gehieneko tamaina 28 MiB-koa409 erantzunean Retry-After badago, itxaron adierazitako denbora. 413 bada, zatitu eskaera eta bidali zatika.
429Upstream-eko hornitzaileak abiadura-muga ezarri dueneanRetry-After badago, jarraitu adierazitakoari; bestela, saiatu berriro atzerapen esponentzialarekin.
5xxAtebidearen edo upstream-aren aldi baterako errorea (503 barne)Saiatu berriro atzerapen esponentzialarekin. Behin eta berriz gertatzen bada, jakinarazi Laguntza eta Kontaktuaren bidez, X-Request-Id-rekin batera.

Berriro saiatzea

Atebideak ez du berezko 429rik sortzen, eta ez ditu upstream-eko erantzunak ezkutuan berriro saiatzen edo ilaran jartzen.
Bezeroak egiten ditu itxaronaldia eta berriro saiatzea.

KodeaItxaron beharreko denboraOndoren
409Retry-After badago, denbora horiEskaera bera berriro bidaltzen du.
429Retry-After badago, denbora hori; bestela, atzerapen esponentzialaEskaera bera berriro bidaltzen du.
5xxAtzerapen esponentzialaBehin eta berriz gertatzen bada, kontsulta bat egiten du.
413Ez da itxaron beharEskaera zatitzen du.

Errorearen gorputza

Errorearen gorputzak forma desberdina du zehaztapenaren arabera. Goranzko erroreetan, mezua soilik utzi eta garbituta igortzen da; pila eta barneko eremuak ez dira helarazten.

OpenAI-rekin bateragarria den bidearen gorputza da.

{
  "error": {
    "message": "API key is required.",
    "type": "invalid_request_error"
  }
}

Anthropic-rekin bateragarria den bidearen gorputza da. error.type egoera-kodearen arabera zehazten da.

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "..."
  },
  "request_id": "rqid..."
}
Anthropic bateragarriaren error.type
Egoera-kodeaerror.type
400invalid_request_error
401authentication_error
403permission_error
404not_found_error
413request_too_large
429rate_limit_error
529overloaded_error
Beste kode batzukapi_error

Mugak eta erabilera egiaztatzea

Muga-balioak desberdinak dira lan-eremu bakoitzean. Egiaztatu 403 errorearen arrazoia error.message-n, eta begiratu balioak beheko pantailan.

Egiaztatu beharrekoaKontsolaren pantaila
Nire lan-eremuari ezarritako mugaIkuspegi orokorreko esleitutako erabilera-muga
Planak baimentzen duen tartea eta saldoaPlana eta kredituak
Benetako erabilera (eredu eta gako bakoitzeko deien kopurua, espero den kreditu-kenketa)Erabilera
Gakoaren egoera (iraungita edo baliogabetuta dagoen)API gakoak
CLEVI

Hizkuntza eta eskualdea

Makina bidez itzulitako hizkuntzak markatuta daude. Erabilgarritasuna argitaratutako gunearen paketearen araberakoa da.

136 hizkuntza

Gomendatua

1

Ekialdeko Asia

7

Hego-ekialdeko Asia

11

Hego Asia

18

Erdialdeko Asia

5

Ekialde Hurbila eta Kaukasoa

10

Mendebaldeko Europa eta Hego Europa

16

Erresuma Batua eta Irlanda

4

Ipar Europa

10

Erdialdeko Europa eta Balkanak

14

Ekialdeko Europa

5

Ekialdeko Afrika

8

Mendebaldeko Afrika eta Erdialdeko Afrika

9

Hegoaldeko Afrika

8

Amerika

5

Ozeania

5