Żbalji

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

L-envelope

error.message hija miktuba għal persuna li taqra log, error.type issemmi l-klassi tal-falliment, u error.code huwa l-identifikatur stabbli biex tiddiċjedi fuqu — it-test tal-messaġġ mhuwiex kuntratt. Fejn l-API għandha dettall strutturat (liema politika, liema endpoint, liema mudell) dan jiġi f'error.llmeu u qatt ma jissostitwixxi t-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" }
  }
}

it-tip isegwi l-istat

Il-mapping t'hawn taħt huwa dak li japplika l-API, magħmul mill-istess tabella li tibni r-risposti tiegħu.

HTTP	tip
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ċi

Kull kodiċi li jista' jilħaq klijent. Test jimxi mal-sors tal-API u jfalli meta din it-tabella u l-kodiċi ma jaqblux f'kull direzzjoni, għalhekk kodiċi ma jistax jiġi inventat 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 falla l-validazzjoni.
400	invalid_json	Il-body ma kienx JSON validu.
400	invalid_llmeu	L-oġġett llmeu ma kienx oġġett, jew kellu field mhux magħruf.
400	invalid_residency	Ir-residenza mitluba mhix waħda mill-erba' klassijiet ta' hosting.
400	invalid_data_class	Id-data_class mitluba mhix waħda mill-erba' klassijiet.
400	invalid_retention	Ir-retention mitluba mhix 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 la string u lanqas array ta' strings.
400	invalid_role	Messaġġ kellu role barra minn system, user, assistant u tool.
400	invalid_tools	tools jew tool_choice kienu malformati.
400	missing_model	Il-field model huwa meħtieġ.
400	missing_messages	messages huma meħtieġa u m'għandhomx ikunu vojta.
400	missing_input	input huwa meħtieġ għall-embeddings.
400	missing_name	name huwa meħtieġ.
401	invalid_api_key	Il-key hija nieqsa, mhux magħrufa, revokata jew skaduta.
402	budget_exceeded	Il-budget tal-ġurnata tal-organizzazzjoni ntefaq. Għolli max_usd_per_day jew stenna li jdur il-window.
403	api_key_required	It-talba użat sessjoni tal-console. Oħloq API key u ibgħat dik minflok.
403	insufficient_scope	Il-key hija valida iżda m'għandhiex l-scope li jeħtieġ dan l-endpoint.
403	no_organization	Il-kredenzjali mhix 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	Ir-retention mitluba hija itwal minn kemm 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 mhix 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 ma jeżistix.
404	unknown_route	L-ebda rotta mhi mmuntata f'dan il-passaġġ. Kull endpoint OpenAI li mhuwiex elenkat taħt Endpoints iwieġeb dan.
404	policy_not_found	Il-policy_id f'llmeu ma jappartjenix lil din l-organizzazzjoni.
409	no_endpoint_for_policy	Xejn ma jissodisfa l-politika u r-residenza flimkien, u l-ebda waħda mhi rilassata bil-moħbi.
409	not_a_text_model	Il-mudell imsemmi ma jistax jiġġenera test: huwa mudell ta' rikonoxximent tal-vuċi, embedding jew reranker.
409	conflict	It-talba tikkonfliġġi mal-istat attwali tal-oġġett.
413	request_too_large	Il-korp qabeż il-limitu tad-daqs tal-endpoint.
429	rate_limit_exceeded	Intlaħaq limitu mit-tabella tal-limiti tar-rata. Il-messaġġ jsemmi l-ħin tar-reset tal-window.
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 fuq dan id-deployment.
501	retention_not_implemented	Il-politika tippermetti żamma li mhix żero u hija implimentata biss żero, għalhekk it-talba tiġi rrifjutata minflok ma tiġi maħżuna.
501	unsupported_n	n akbar minn 1 mhux appoġġat.
502	upstream_error	L-ebda endpoint ma seta' jservi t-talba wara failover. It-traċċa tirreġistra kull tentattiv.
502	stream_failed	Il-fluss falla wara li kien diġà beda.

no_endpoint_for_policy huwa l-prodott li 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 jillaxka xi wieħed minnhom bil-moħbi. Mhuwiex tranżitorju: jekk terġa' tipprova mingħajr ma tibdel it-talba, il-politika jew ir-residenza, jfalli bl-istess mod. L-iżball iġorr ir-residenza mitluba, u t-trace jirrekordja għaliex kull endpoint ġie miċħud.

Żbalji ġewwa stream

Talba streaming li tfalli wara li jintbagħtu l-headers tikteb l-iżball bħala frame SSE finali u mbagħad it-terminatur, 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]