Developer guide

Cod gwall

Ymdrin â chodau statws a rheolau aildroi

Mae’r dudalen hon yn crynhoi’r codau statws a ddychwelir gan y porth, eu hystyr, a’r camau gweithredu ar gyfer pob cod.
Pan fydd yr uwchffrwd yn rhoi 4xx·5xx, caiff y cod hwnnw ei drosglwyddo fel y mae; ym mhob achos arall, dilynir y tabl isod.
Rydym hefyd yn cynnwys siâp cyrff gwall y ddwy fanyleb gydnaws, rheolau error.type sy’n gydnaws ag Anthropic, a sgriniau’r consol ar gyfer gwirio terfynau a defnydd.

Cod statws

CodYstyrCam gweithredu
400Gwall yng ngwerthoedd y cais. Mae limit rhestr modelau sy’n gydnaws ag Anthropic y tu allan i’r ystod 1~1000, neu ceisiwyd parhau ag ymateb sydd wedi’i gadw gan ddefnyddio GET /responses/{responseId}?stream=trueCywirwch y gwerth i fod o fewn yr ystod. Holwch yr ymateb sydd wedi’i gadw heb stream.
401Allwedd ar goll neu allwedd sydd wedi dod i ben neu wedi’i dirymuGwiriwch statws yr allwedd ar sgrin allweddi API, a gwiriwch enw’r pennyn a rhagddodiad Bearer.
403Dim caniatâd i gael mynediad at y model, terfyn defnydd wedi’i ragori, dim digon o gredydau, neu nid ydych yn berchennog y llaisMae error.message yn gwahaniaethu rhwng y rhesymau. Gweler y gwerthoedd ar sgrin yr adran gwirio terfynau a defnydd isod.
404Nid yw’r model yn bodoli neu ni ellir cael mynediad ato gyda’r allwedd hon (gan gynnwys modelau nad ydynt bellach yn cael eu cefnogi), llwybr nad yw’n bodoli, neu allbwn CleviDrive sydd wedi mynd y tu hwnt i’r cyfnod cadw o 3 diwrnodGwiriwch yn gyntaf y rhestr o fodelau y gellir eu galw gyda GET /models. Cymharwch y llwybr â’r tabl ar y dudalen Galw’r API.
408 · 409 · 413Terfyn amser yr uwchffrwd, tagfeydd, neu faint y cais yn rhy fawr. Y terfyn amser ar gyfer llwybrau llais a llais yw 5 munud, a therfyn maint y cais yw 28 MiBOs oes Retry-After yn 409, arhoswch am yr amser hwnnw. Rhannwch y cais yn 413 yn sawl rhan.
429Pan fydd y darparwr uwchffrwd yn gosod terfyn cyfraddOs rhoddir Retry-After, dilynwch ef fel y mae; fel arall, ceisiwch eto gan ddefnyddio ôl-afael esbonyddol.
5xxGwall dros dro yn y porth neu’r uwchffrwd (gan gynnwys 503)Ceisiwch eto gan ddefnyddio ôl-afael esbonyddol. Os bydd yn digwydd dro ar ôl tro, rhowch wybod i ni drwy Help a Chysylltu, gan gynnwys X-Request-Id.

Aildroi

Nid yw’r porth yn creu 429 ar ei ben ei hun, ac nid yw’n ailgeisio ymatebion yr uwchffrwd yn dawel nac yn eu rhoi mewn ciw.
Y cleient sy’n aros ac yn ailgeisio.

CodAmser arosBeth i'w wneud wedyn
409Os oes Retry-After, yr amser hwnnwAnfonwch yr un cais eto.
429Os oes Retry-After, yr amser hwnnw; os nad oes, oedi esbonyddolAnfonwch yr un cais eto.
5xxOedi esbonyddolOs bydd yn digwydd dro ar ôl tro, cysylltwch â ni.
413Dim arosRhannwch y cais.

Corff gwall

Mae siâp corff y gwall yn amrywio yn ôl y fanyleb. Ar gyfer gwallau o fyny'r afon, dim ond y neges a gedwir a'i threfnu i'w throsglwyddo; ni chaiff y pentwr na'r meysydd mewnol eu trosglwyddo.

Dyma gorff ymateb y llwybr sy'n gydnaws ag OpenAI.

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

Dyma gorff ymateb y llwybr sy'n gydnaws ag Anthropic. Pennir error.type gan y cod statws.

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "..."
  },
  "request_id": "rqid..."
}
error.type sy'n gydnaws ag Anthropic
Cod statwserror.type
400invalid_request_error
401authentication_error
403permission_error
404not_found_error
413request_too_large
429rate_limit_error
529overloaded_error
Codau eraillapi_error

Gwirio terfynau a defnydd

Mae ffigurau'r terfynau'n amrywio yn ôl gweithfan. Gwiriwch reswm 403 yn error.message, ac yna edrychwch ar y ffigurau yn y sgrin isod.

Beth i'w wirioSgrin y consol
Y terfyn a osodwyd ar fy ngweithfanTerfyn defnydd wedi'i ddyrannu yn y trosolwg
Yr ystod a ganiateir gan y cynllun a'r balansCynllun a chredydau
Y defnydd gwirioneddol (nifer y galwadau fesul model ac allwedd, credydau a dynnir yn ôl y disgwyl)Defnydd
Statws yr allwedd (a yw wedi dod i ben neu wedi'i dirymu)Allweddi API
CLEVI

Iaith a rhanbarth

Mae ieithoedd a gyfieithwyd gan beiriant wedi’u marcio. Mae argaeledd yn dilyn y bwndel gwefan cyhoeddedig.

136 iaith

Argymhellir

1

Dwyrain Asia

7

De-Ddwyrain Asia

11

De Asia

18

Canol Asia

5

Y Dwyrain Canol a’r Cawcasws

10

Gorllewin Ewrop a(c) De Ewrop

16

Y Deyrnas Unedig a(c) Iwerddon

4

Gogledd Ewrop

10

Canolbarth Ewrop a’r Balcanau

14

Dwyrain Ewrop

5

Dwyrain Affrica

8

Gorllewin Affrica a(c) Canol Affrica

9

Deheudir Affrica

8

Yr Amerig

5

Oceania

5