Gabimet e API-t

Kjo faqe ofron një referencë për kodet e gabimeve të backend-it të kthyera nga GenerateContent API, përshkruan formatin e përgjigjes së gabimit gRPC dhe ofron hapa për zgjidhjen e problemeve.

Kodet e gabimeve HTTP

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

Kodi HTTP Statusi Përshkrimi Shembull Zgjidhje
400 ARGUMENT_I_PAVLEFSHËM Trupi i kërkesës është i keqformuar. Ka një gabim shtypi ose mungon një fushë e detyrueshme në kërkesën tuaj. Kontrolloni referencën e API-t 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-t me një pikë fundore më të vjetër mund të shkaktojë gabime.
400 PARËKUSHTESA_E_DËSHTUAR Niveli falas i Gemini API nuk është i disponueshëm në vendin tuaj. Ju lutemi aktivizoni faturimin për projektin tuaj në Google AI Studio. Po bëni një kërkesë në një rajon ku niveli falas nuk mbështetet dhe nuk e keni aktivizuar faturimin për projektin tuaj në Google AI Studio. Për të përdorur Gemini API, do t'ju duhet të konfiguroni një plan me pagesë duke përdorur Google AI Studio .
403 PERMISSION_DENIED Çelësi juaj API nuk ka lejet e kërkuara. Po përdorni çelësin e gabuar API; po përpiqeni të përdorni një model të akorduar pa kaluar nëpër autentifikimin e duhur . Kontrolloni që çelësi juaj API të jetë vendosur dhe të ketë aksesin e duhur. Dhe sigurohuni që të kaloni nëpër autentifikimin e duhur për të përdorur modelet e akorduara.
404 NUK_GJENDET Burimi i kërkuar nuk u gjet. Një skedar imazhi, audioje ose videoje i referuar në kërkesën tuaj nuk u gjet. Kontrolloni nëse të gjithë parametrat në kërkesën tuaj janë të vlefshëm për versionin tuaj të API-t.
429 RESOURCE_EXHAUSTED Ke tejkaluar një nga limitet e shpejtësisë së API-t (RPM, TPM, RPD, shpenzime, etj.). Po dërgoni shumë kërkesa, po përdorni shumë tokena ose po tejkaloni limitet e shpenzimeve për historikun dhe nivelin e faturimit të llogarisë suaj. Verifikoni që jeni brenda kufijve të modelit. Prisni dhe riprovoni pas një periudhe të shkurtër. Ulni shpejtësinë ose madhësinë e kërkesave tuaja. Kërkoni një rritje të kufirit të shpejtësisë nëse është e nevojshme.
499 ANULOHET Operacioni u anulua, zakonisht nga telefonuesi. Klienti e mbylli lidhjen përpara se API të mund të përfundonte përgjigjen. Kontrolloni nëse klienti ose infrastruktura e rrjetit tuaj po e mbyll lidhjen para kohe (p.sh., për shkak të një skadimi kohor në anën e klientit).
500 I BRENDSHËM Ndodhi një gabim i papritur në anën e Google. Konteksti i të dhënave është shumë i gjatë. Kontrolloni faqen e statusit të Gemini API për çdo incident të vazhdueshëm. Zvogëloni kontekstin e të dhënave hyrëse ose kaloni përkohësisht në një model tjetër (p.sh. nga Gemini 2.5 Pro në Gemini 2.5 Flash) dhe shikoni nëse funksionon. Ose prisni pak dhe riprovoni kërkesën tuaj. Nëse problemi vazhdon pas riprovimit, ju lutemi raportojeni atë duke përdorur butonin Dërgo reagime në Google AI Studio.
503 I PADISPONUESHËM Shërbimi mund të jetë i mbingarkuar përkohësisht ose jashtë funksionit. Shërbimi është përkohësisht pa kapacitet. Kontrolloni faqen e statusit të Gemini API për çdo incident të vazhdueshëm. Kaloni përkohësisht në një model tjetër (p.sh. nga Gemini 2.5 Pro në Gemini 2.5 Flash) dhe shikoni nëse funksionon. Ose prisni pak dhe riprovoni kërkesën tuaj. Nëse problemi vazhdon pasi ta riprovoni, ju lutemi raportojeni atë duke përdorur butonin Dërgo reagime në Google AI Studio.
504 AFAT I KALUAR Shërbimi nuk është në gjendje të përfundojë përpunimin brenda afatit të caktuar. Kërkesa (ose konteksti) juaj është shumë e gjatë për t'u përpunuar në kohë. Caktoni një 'kohëzgjatje' më të madhe në kërkesën e klientit tuaj për të shmangur këtë gabim.

Formati i përgjigjes së gabimit

Kur një kërkesë GenerateContent dështon, API vendos kodin e statusit HTTP (si p.sh. 400 Bad Request e Gabuar), 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."
      }
    ]
  }
}
Fushë 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 varg Kontekst shtesë gabimi, siç janë ErrorInfo ose LocalizedMessage .

Çfarë vjen më pas