Udhëzues për zgjidhjen e problemeve

Përdoreni këtë udhëzues për t'ju ndihmuar të diagnostikoni dhe zgjidhni problemet e zakonshme që lindin kur telefononi Gemini API. Mund të hasni probleme ose nga shërbimi mbështetës i Gemini API ose nga SDK-të e klientit. SDK-të e klientëve tanë janë me burim të hapur në depot e mëposhtme:

• piton-genai
• js-genai
• go-genai

Nëse hasni probleme kyçe API, verifikoni që e keni konfiguruar saktë çelësin tuaj API sipas udhëzuesit të konfigurimit të çelësit API .

Kodet e gabimit të shërbimit të backend të Gemini API

Tabela e mëposhtme liston kodet e zakonshme të gabimit të backend që mund të hasni, së bashku me shpjegimet për shkaqet e tyre dhe hapat e zgjidhjes së problemeve:

Kontrolloni thirrjet tuaja API për gabime në parametrat e modelit

Verifikoni që parametrat e modelit tuaj janë brenda vlerave të mëposhtme:

Përveç kontrollit të vlerave të parametrave, sigurohuni që po përdorni versionin e saktë të API-së (p.sh., /v1 ose /v1beta ) dhe modelin që mbështet veçoritë që ju nevojiten. Për shembull, nëse një veçori është në versionin Beta, ai do të jetë i disponueshëm vetëm në versionin /v1beta API.

Kontrolloni nëse keni modelin e duhur

Verifikoni që po përdorni një model të mbështetur të listuar në faqen tonë të modeleve .

Vonesa më e lartë ose përdorimi i tokenit me modelet 2.5

Nëse jeni duke vëzhguar vonesë më të lartë ose përdorim të tokenit me modelet 2.5 Flash dhe Pro, kjo mund të ndodhë sepse ato vijnë me të menduarit aktivizuar si parazgjedhje për të përmirësuar cilësinë. Nëse jeni duke i dhënë përparësi shpejtësisë ose keni nevojë të minimizoni kostot, mund ta rregulloni ose çaktivizoni të menduarit.

Referojuni faqes së të menduarit për udhëzime dhe kodin e mostrës.

Çështjet e sigurisë

Nëse shihni se një kërkesë është bllokuar për shkak të një cilësime sigurie në thirrjen tuaj API, rishikoni kërkesën në lidhje me filtrat që keni vendosur në thirrjen API.

Nëse shihni BlockedReason.OTHER , pyetja ose përgjigja mund të shkelë kushtet e shërbimit ose të mos mbështetet ndryshe.

Çështja e recitimit

Nëse shihni se modeli ndalon së prodhuari dalje për shkak të arsyes së REKITIMIT, kjo do të thotë se prodhimi i modelit mund të ngjajë me të dhëna të caktuara. Për ta rregulluar këtë, përpiquni ta bëni kërkesën / kontekstin sa më unik të jetë e mundur dhe përdorni një temperaturë më të lartë.

Çështje të përsëritura të argumenteve

Nëse shihni shenja të përsëritura të daljes, provoni sugjerimet e mëposhtme për të ndihmuar në uljen ose eliminimin e tyre.

          # Markdown Table Format
          
          * Separator line: Markdown tables must include a separator line below
            the header row. The separator line must use only 3 hyphens per
            column, for example: |---|---|---|. Using more hypens like
            ----, -----, ------ can result in errors. Always
            use |:---|, |---:|, or |---| in these separator strings.

            For example:

            | Date | Description | Attendees |
            |---|---|---|
            | 2024-10-26 | Annual Conference | 500 |
            | 2025-01-15 | Q1 Planning Session | 25 |

          * Alignment: Do not align columns. Always use |---|.
            For three columns, use |---|---|---| as the separator line.
            For four columns use |---|---|---|---| and so on.

          * Conciseness: Keep cell content brief and to the point.

          * Never pad column headers or other cells with lots of spaces to
            match with width of other content. Only a single space on each side
            is needed. For example, always do "| column name |" instead of
            "| column name                |". Extra spaces are wasteful.
            A markdown renderer will automatically take care displaying
            the content in a visually appealing form.
        

        When thinking silently: ALWAYS start the thought with a brief
        (one sentence) recap of the current progress on the task. In
        particular, consider whether the task is already done.
      

Përmirësoni prodhimin e modelit

Për rezultate të modelit me cilësi më të lartë, eksploroni shkrimin e kërkesave më të strukturuara. Faqja e udhëzuesit të shpejtë të inxhinierisë prezanton disa koncepte bazë, strategji dhe praktika më të mira për të filluar.

Nëse keni qindra shembuj të çifteve të mira hyrëse/dalëse, mund të konsideroni gjithashtu akordimin e modelit .

Kuptoni kufijtë e shenjave

Lexoni udhëzuesin tonë Token për të kuptuar më mirë se si të numëroni argumentet dhe kufijtë e tyre.

Çështje të njohura

• API mbështet vetëm një numër gjuhësh të zgjedhura. Dorëzimi i kërkesave në gjuhë të pambështetura mund të prodhojë përgjigje të papritura apo edhe të bllokuara. Shikoni gjuhët e disponueshme për përditësime.

Paraqisni një gabim

Bashkohuni me diskutimin në forumin e zhvilluesve të Google AI nëse keni pyetje.