Żbalji

Kull kodiċi ta' żball li din l-API tista' twieġeb bih, l-istatus HTTP li jġorr, u x'għandek tagħmel dwaru. L-envelope hija b'forma OpenAI b'żieda waħda b'namespace.

L-envelope

error.message hija miktuba għal persuna li taqra log, error.type isemmi l-klassi tal-falliment, u error.code huwa l-identifikatur stabbli biex wieħed jibbaża fuqu — it-test tal-messaġġ mhuwiex kuntratt. Fejn l-API għandha dettall strutturat (liema politika, liema endpoint, liema mudell) dan jasal f'error.llmeu u qatt ma jieħu post it-tliet fields standard.

{
  "error": {
    "message": "No endpoint satisfies residency eu-owned. Residency is never relaxed silently.",
    "type": "conflict_error",
    "code": "no_endpoint_for_policy",
    "llmeu": { "requested": "llmeu-auto" }
  }
}

type isegwi l-istatus

Il-mapping hawn taħt huwa dak li tapplika l-API, muri mill-istess tabella li tibni r-risposti tagħha.

HTTP	type
400	invalid_request_error
401	authentication_error
402	insufficient_quota
403	permission_error
404	not_found_error
409	conflict_error
413	invalid_request_error
422	invalid_request_error
429	rate_limit_error
500	api_error
501	api_error
502	api_error
503	api_error

Kodiċijiet

Kull kodiċi li jista' jasal għal klijent. Test jgħaddi mis-sors tal-API u jonqos meta din it-tabella u l-kodiċi ma jaqblux f'kull direzzjoni, għalhekk kodiċi ma jistax jiġi invenzat hawn jew miżjud hemm mingħajr ma jiġi dokumentat.

HTTP	code	Xi jfisser, u x'għandek tagħmel
400	invalid_request	Il-body tat-talba naqas mill-validazzjoni.
400	invalid_json	Il-body ma kienx JSON validu.
400	invalid_llmeu	L-oġġett llmeu ma kienx oġġett, jew kien iġorr field mhux magħruf.
400	invalid_residency	Ir-residenza mitluba mhijiex waħda mill-erba' klassijiet ta' hosting.
400	invalid_data_class	Id-data_class mitluba mhijiex waħda mill-erba' klassijiet.
400	invalid_retention	Ir-retention mitluba mhijiex zero, 24h, 7d jew 30d.
400	invalid_max_tokens	max_tokens ma kienx integer pożittiv.
400	invalid_stream	stream ma kienx boolean.
400	invalid_stop	stop ma kienx string u lanqas array ta' strings.
400	invalid_role	Messaġġ kien iġorr role barra minn system, user, assistant u tool.
400	invalid_tools	tools jew tool_choice kienu f'format ħażin.
400	missing_model	Il-qasam model huwa meħtieġ.
400	missing_messages	messages huwa meħtieġ u m'għandux ikun vojt.
400	missing_input	input huwa meħtieġ għall-embeddings.
400	missing_name	name huwa meħtieġ.
401	invalid_api_key	Iċ-ċavetta hija nieqsa, mhux magħrufa, irrevokata jew skaduta.
402	budget_exceeded	Il-baġit ta' kuljum tal-organizzazzjoni ntefa'. Għolli max_usd_per_day jew stenna li tinbidel it-tieqa.
403	api_key_required	It-talba użat sessjoni tal-console. Oħloq ċavetta API u ibgħat dik minflok.
403	insufficient_scope	Iċ-ċavetta hija valida iżda m'għandhiex l-ambitu li jeħtieġ dan l-endpoint.
403	no_organization	Il-kredenzjali mhijiex marbuta ma' organizzazzjoni.
403	model_denied	Il-politika tal-organizzazzjoni tiċħad dan il-mudell jew il-fornitur tiegħu.
403	policy_violation	It-talba tikser regola tal-politika tal-organizzazzjoni.
403	retention_exceeds_policy	Iż-żamma mitluba hija itwal milli tippermetti l-politika. Dan jiġi ċċekkjat qabel kull ħaġa oħra dwar it-talba.
403	data_class_not_allowed	Id-data_class tat-talba mhijiex waħda li tippermetti l-politika.
404	model_not_found	M'hemmx mudell bħal dan għal din l-organizzazzjoni.
404	hosted_unavailable	Il-mudell jinsab fil-katalgu iżda mhux ospitat fuq LLM EU, għalhekk ma jistax jiġi msejjaħ.
404	not_found	Ir-rotta teżisti iżda l-oġġett le.
404	unknown_route	L-ebda rotta mhi mmuntata f'dan il-path. Kull endpoint OpenAI li mhux elenkat taħt Endpoints iwieġeb dan.
404	policy_not_found	Il-policy_id f'llmeu ma jappartjenix għal din l-organizzazzjoni.
409	no_endpoint_for_policy	Xejn ma jissodisfa l-politika u r-residenza flimkien, u l-ebda waħda mhija rrilassata bil-moħbi.
409	not_a_text_model	Il-mudell imsemmi ma jistax jiġġenera test: huwa mudell ta' rikonoxximent tad-diskors, embedding jew reranker.
409	conflict	It-talba tikkonfliġġi mal-istat attwali tal-oġġett.
413	request_too_large	Il-body qabeż il-limitu tad-daqs tal-endpoint.
429	rate_limit_exceeded	Intlaħaq limitu mit-tabella tal-limiti tar-rata. Il-messaġġ isemmi l-ħin ta' reset tat-tieqa.
500	internal_error	Falliment mhux mistenni min-naħa tagħna.
501	not_implemented	L-endpoint mhux offrut apposta, jew il-kapaċità mitluba ma teżistix f'dan l-iskjerament.
501	retention_not_implemented	Il-politika tippermetti żamma għajr żero u hija implimentata biss żero, għalhekk it-talba tiġi rrifjutata minflok ma tinħażen.
501	unsupported_n	n akbar minn 1 mhuwiex appoġġjat.
502	upstream_error	L-ebda endpoint ma seta' jaqdi t-talba wara failover. It-traċċa tirrekordja kull tentattiv.
502	stream_failed	L-istream falla wara li kien diġà beda.

no_endpoint_for_policy huwa l-prodott jaħdem

409 b'dan il-kodiċi jfisser li l-politika u t-talba flimkien ma jammettu l-ebda endpoint, u r-router irrifjuta li jirrilassa wieħed minnhom bil-moħbi. Mhuwiex transient: jekk terġa' tipprova mingħajr ma tibdel it-talba, il-politika jew ir-residenza, jonqos bl-istess mod. L-iżball iġorr ir-residenza mitluba, u t-trace jirrekordja għaliex kull endpoint ġie rifjutat.

Żbalji ġewwa stream

Talba streaming li tonqos wara li jintbagħtu l-headers tikteb l-iżball bħala frame SSE finali u mbagħad it-terminator, għalhekk klijent li jsegwi l-format jara falliment minflok suċċess maqtugħ.

data: {"error":{"message":"No endpoint could start the stream.","type":"api_error","code":"upstream_error"}}

data: [DONE]