Gabimet e API-së

Kjo faqe ofron një referencë për kodet e gabimeve të sistemit fundor të kthyera nga GenerateContent API, përshkruan formatin e përgjigjes së gabimit gRPC dhe ofron hapat për zgjidhjen e problemeve.

Kodet e gabimeve të HTTP-së

Tabela e mëposhtme liston kodet e zakonshme të gabimeve të backend-it, shpjegimet për shkaqet e tyre dhe zgjidhjet e rekomanduara:

Kodi HTTP Statusi Përshkrimi Shembull Zgjidhja
400 INVALID_ARGUMENT Trupi i kërkesës është me formë të gabuar. Ka një gabim shtypi ose mungon një fushë e kërkuar në kërkesën tënde. Kontrollo referencën e API-së për formatin e kërkesës, shembujt dhe versionet e mbështetura. Përdorimi i veçorive nga një version më i ri i API-së me një pikë fundore më të vjetër mund të shkaktojë gabime.
400 FAILED_PRECONDITION Niveli falas i Gemini API nuk ofrohet në shtetin tënd. Aktivizo faturimin në projektin tënd në Google AI Studio. Po bën një kërkesë në një rajon ku niveli falas nuk mbështetet dhe nuk ke aktivizuar faturimin në projektin tënd në Google AI Studio. Për të përdorur Gemini API, do të të duhet të konfigurosh një plan me pagesë duke përdorur Google AI Studio.
402 RESOURCE_EXHAUSTED Balanca jote e kreditit me parapagim është shteruar. Llogarisë sate të faturimit i kanë mbaruar kreditet me parapagim, kështu që çdo çelës API i lidhur me atë llogari faturimi ndalon së funksionuari. Shto kredite në llogarinë tënde të faturimit ose aktivizo rimbushjen automatike. Mos e provo përsëri këtë kërkesë: ajo nuk do të ketë sukses derisa të shtohen kreditet.
403 PERMISSION_DENIED Çelësi yt API nuk ka lejet e kërkuara ose qasja në API e projektit tënd është e kufizuar. Po përdor një çelës të gabuar ose të nxjerrë të API-së, projekti yt nuk kualifikohet për nivelin falas, llogaria jote e faturimit ka një balancë të papaguar ose po përpiqesh të përdorësh një model të sintonizuar pa kaluar nëpër vërtetimin e duhur. Kontrollo që çelësi yt i API-së të jetë i vlefshëm dhe aktiv, verifiko statusin e faturimit dhe të nivelit të projektit tënd në Google AI Studio ose shiko Zgjidh problemin e projektit të kufizuar ose të padisponueshëm.
404 NOT_FOUND Burimi i kërkuar nuk u gjet. Një skedar imazhi, audioje ose videoje i referuar në kërkesën tënde nuk u gjet. Kontrollo nëse të gjithë parametrat në kërkesën tënde janë të vlefshëm për versionin tënd të API-së.
429 RESOURCE_EXHAUSTED Ke tejkaluar një nga kufijtë e normës së API-së (RPM, TPM, RPD, shpenzimet etj.). Po dërgon shumë kërkesa, po përdor shumë tokenë ose po i tejkalon kufijtë e bazuar në shpenzime për historikun e faturimit dhe nivelin e llogarisë sate. Verifiko që je brenda kufijve të normës të modelit. Prit dhe provo përsëri pas një periudhe të shkurtër. Zvogëlo normën ose madhësinë e kërkesave të tua. Kërko një rritje të kufirit të normës nëse nevojitet.
499 ANULUAR Veprimi u anulua, zakonisht nga telefonuesi. Klienti e mbylli lidhjen para se API të mund të përfundonte përgjigjen. Kontrollo nëse infrastruktura e klientit ose e rrjetit po e mbyll lidhjen para kohe (p.sh. për shkak të një skadimi të kohës në anën e klientit).
500 I BRENDSHËM Ndodhi një gabim i papritur në anën e Google. Konteksti i hyrjes sate është shumë i gjatë. Kontrollo faqen e statusit të Gemini API për çdo incident në vazhdim. Redukto kontekstin e hyrjes ose kalo përkohësisht te një model tjetër (p.sh. nga Gemini 2.5 Pro te Gemini 2.5 Flash) dhe shiko nëse funksionon. Ose prit pak dhe provoje përsëri kërkesën tënde. Nëse problemi vazhdon pas rithirrjes, raportoje atë duke përdorur butonin Dërgo komente në Google AI Studio.
503 NUK OFROHET Shërbimi mund të jetë i mbingarkuar ose jofunksional përkohësisht. Shërbimi nuk ka kapacitet përkohësisht. Kontrollo faqen e statusit të Gemini API për çdo incident në vazhdim. Kalo përkohësisht te një model tjetër (p.sh. nga Gemini 2.5 Pro te Gemini 2.5 Flash) dhe shiko nëse funksionon. Ose prit pak dhe provoje përsëri kërkesën tënde. Nëse problemi vazhdon pas rithirrjes, raportoje atë duke përdorur butonin Dërgo komente në Google AI Studio.
504 DEADLINE_EXCEEDED Shërbimi nuk mund ta përfundojë përpunimin brenda afatit. Kërkesa (ose konteksti) jote është shumë e madhe për t'u përpunuar në kohë. Cakto një 'kohë pritjeje' më të madhe në kërkesën e klientit për të shmangur këtë gabim.

Formati i përgjigjes me gabim

Kur një kërkesë e GenerateContent dështon, API-ja cakton kodin e statusit HTTP (si p.sh. 400 Bad Request, 403 Forbidden ose 429 Too Many Requests) dhe kthen një trup përgjigjeje JSON që përmban detajet e statusit gRPC:

{
  "error": {
    "code": 400,
    "message": "API key not valid. Please pass a valid API key.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "API_KEY_INVALID",
        "domain": "googleapis.com",
        "metadata": {
          "service": "generativelanguage.googleapis.com"
        }
      },
      {
        "@type": "type.googleapis.com/google.rpc.LocalizedMessage",
        "locale": "en-US",
        "message": "API key not valid. Please pass a valid API key."
      }
    ]
  }
}
Fusha Lloji Përshkrimi
code numër i plotë Kodi i statusit HTTP.
message varg Një përshkrim i lexueshëm nga njeriu i gabimit.
status varg Kodi i statusit gRPC në SCREAMING_CASE.
details matrica Kontekst shtesë i gabimit, si p.sh. ErrorInfo ose LocalizedMessage.

Çfarë ka më pas