Gabimet e API-t

Kjo faqe ofron një referencë për të gjitha kodet e gabimeve të Interactions API, përshkruan formatin e përgjigjes ndaj gabimit dhe shpjegon se si API-ja jep gabime për lloje të ndryshme kërkesash.

Kodet standarde të gabimeve të API-t

Këto kode të përgjithshme gabimi në nivel kërkese korrespondojnë me kodet standarde të statusit HTTP. Përdorni fushën e code në logjikën e aplikacionit tuaj për të trajtuar gabimet në mënyrë programore.

Kodi Statusi i HTTP-së Përshkrimi Veprim i rekomanduar
invalid_request 400 Kërkesë e gabuar Kërkesa është e keqformuar ose përmban parametra të pavlefshëm. Kontrolloni të dhënat tuaja kundrejt referencës API .
parameter_unknown 400 Kërkesë e gabuar Kërkesa përmban një parametër të panjohur. Hiq parametrin e panjohur dhe provo përsëri.
authentication 401 I paautorizuar Çelësi API mungon ose është i pavlefshëm. Verifikoni çelësin tuaj API .
permission_denied 403 I ndaluar Çelësi juaj API nuk ka leje për këtë burim. Kontrolloni lejet e çelësit API dhe aksesin në projekt.
not_found 404 Nuk u gjet Burimi i kërkuar nuk u gjet. Verifikoni rrugën dhe parametrat e burimit.
model_not_found 404 Nuk u gjet Modeli i specifikuar nuk u gjet. Verifikoni emrin e modelit ose kthehuni te një model tjetër.
rate_limit_exceeded 429 Shumë kërkesa Ke tejkaluar limitin e kërkesës ose tokenit për minutë ose për sekondë. Prit dhe provo përsëri me tërheqje eksponenciale.
quota_exceeded 429 Shumë kërkesa E ke tejkaluar kuotën tënde ditore. Prisni derisa kuota të rivendoset ose kërkoni një rritje të kuotës.
cancelled 499 Kërkesë e Mbyllur nga Klienti Klienti e anuloi kërkesën përpara se ajo të përfundonte. Nuk nevojitet asnjë veprim. Kjo zakonisht do të thotë që klienti është shkëputur.
api_error Gabim i brendshëm i serverit 500 Ndodhi një gabim i papritur në server. Provo përsëri kërkesën. Nëse vazhdon, kontakto mbështetjen.
service_unavailable Shërbimi 503 i Padisponueshëm Shërbimi është përkohësisht i mbingarkuar ose jashtë funksionit. Prit dhe provo përsëri me tërheqje eksponenciale.

Gjenerimi i kodeve të bllokuara

Këto kode gabimi tregojnë se kufizimet e politikave, sigurisë ose përmbajtjes kanë bllokuar daljen e modelit. Kur të merrni një nga këto kode, modifikoni të dhënat e dhëna dhe provoni përsëri.

Kodi Përshkrimi
safety Shkeljet e sigurisë (përmbajtje e dëmshme) e bllokuan kërkesën.
recitation Kufizimet e të drejtave të autorit ose të recitimit e bllokuan kërkesën.
language Një gjuhë e pambështetur e bllokoi kërkesën.
prohibited_content Udhëzimet për përmbajtjen e ndaluar e bllokuan kërkesën.
spii Kufizimet për Informacionin Personal të Identifikueshëm të Ndjeshëm e bllokuan kërkesën.
blocklist Termat e ndaluar në një listë bllokimi e bllokuan kërkesën.
image_safety Shkeljet e sigurisë bllokuan gjenerimin e imazheve.
image_prohibited_content Udhëzimet për përmbajtjen e ndaluar bllokuan gjenerimin e imazheve.
image_recitation Kufizimet e të drejtave të autorit ose të recitimit bllokuan gjenerimin e imazheve.
image_other Arsyet e paspecifikuara bllokuan gjenerimin e imazheve.
content_blocked Një arsye e paspecifikuar politike e bllokoi kërkesën.

Kodet e gabimit të gjenerimit

Këto kode gabimi tregojnë një problem strukturor me rezultatin e gjeneruar të modelit (siç është një thirrje funksioni e keqformuar ose një thirrje mjeti e padeklaruar).

Kodi Përshkrimi
malformed_function_call Modeli prodhoi një thirrje funksioni që nuk mund të analizohej.
malformed_tool_call Modeli prodhoi një thirrje mjeti që nuk mund të analizohej.
unexpected_tool_call Modeli thirri një mjet që nuk ishte deklaruar në kërkesë.
no_image Modeli nuk ishte në gjendje të gjeneronte një imazh.
too_many_tool_calls Modeli gjeneroi më shumë thirrje mjetesh sesa lejohej.
missing_thought_signature Përgjigjes i mungon një nënshkrim i detyrueshëm i mendimit.

Formati i përgjigjes së gabimit

Të gjitha gabimet nga Interactions API kthejnë një objekt error që përmban një code dhe message . Për shembull, kalimi i një lloji mjeti të pambështetur kthen:

{
  "error": {
    "code": "invalid_request",
    "message": "The value 'invalid_tool_type_xyz' is not supported for 'type' at 'tools[0]'. Supported values: 'function', 'code_execution', 'mcp_server', 'filesystem', 'google_maps', 'google_search', 'bash', 'computer_use', 'file_search', 'url_context'."
  }
}
Fushë Lloji Përshkrimi
code varg Një kod gabimi i lexueshëm nga makina në snake_case .
message varg Një përshkrim i lexueshëm nga njeriu i asaj që shkoi keq.

Si paraqiten gabimet

API-ja jep gabime ndryshe në varësi të faktit nëse bëni një kërkesë standarde HTTP apo një kërkesë transmetimi (SSE).

Kërkesat standarde HTTP

Për kërkesat standarde (jo-transmetuese), API-ja cakton kodin e statusit të përgjigjes HTTP (si p.sh. 400 Bad Request , 401 Unauthorized ose 429 Too Many Requests ) dhe kthen një objekt error në trupin e përgjigjes JSON:

{
  "error": {
    "code": "invalid_request",
    "message": "The value 'invalid_tool_type_xyz' is not supported for 'type' at 'tools[0]'."
  }
}

Kërkesat për transmetim (SSE)

Për kërkesat e transmetimit ( stream: true ), API dërgon ngjarje gabimi përmes rrjedhës së Ngjarjeve të Dërguara nga Serveri (SSE) me event_type të vendosur në "error" . Fusha e error përmban të njëjtin code dhe strukturë message :

{
  "event_type": "error",
  "error": {
    "code": "not_found",
    "message": "Failed to get completed interaction: Result not found."
  }
}

Për skemën e plotë të ngjarjeve SSE, shihni Referencën e API-t të Ndërveprimeve .

Çfarë vjen më pas