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 thirrni Gemini API. Mund të hasni probleme ose nga shërbimi i prapavijës së Gemini API ose nga SDK-të e klientit. SDK-të e klientit tonë janë me burim të hapur në depot e mëposhtme:

• python-genai
• js-genai
• go-genai

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

Kodet e gabimeve të shërbimit të backend-it të API-t Gemini

Tabela e mëposhtme rendit kodet e zakonshme të gabimeve në 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 të parametrave të 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-t (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, ajo do të jetë e disponueshme vetëm në versionin /v1beta të API-t.

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 ose përdorim më i lartë i tokenëve me modelet 2.5

Nëse vini re vonesë ose përdorim më të lartë të tokenëve me modelet 2.5 Flash dhe Pro, kjo mund të ndodhë sepse ato vijnë me të menduarit që është aktivizuar si parazgjedhje për të përmirësuar cilësinë. Nëse po i jepni përparësi shpejtësisë ose keni nevojë të minimizoni kostot, mund ta përshtatni ose çaktivizoni të menduarit.

Referojuni faqes së të menduarit për udhëzime dhe kod shembull.

Çështje sigurie

Nëse shihni se një kërkesë është bllokuar për shkak të një cilësimi 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ërgjigjja mund të shkelë kushtet e shërbimit ose të mos mbështetet për ndonjë arsye tjetër.

Çështja e recitimit

Nëse shihni që modeli ndalon së gjeneruari rezultate për shkak të arsyes RECITATION, kjo do të thotë që rezultati 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ë.

Problem me tokenët përsëritës

Nëse shihni tokena dalës të përsëritura, provoni sugjerimet e mëposhtme për t'i zvogëluar ose eliminuar ato.

          # 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ëso prodhimin e modelit

Për rezultate modelesh me cilësi më të lartë, eksploroni shkrimin e pyetjeve më të strukturuara. Faqja e udhëzuesit të inxhinierisë së pyetjeve prezanton disa koncepte bazë, strategji dhe praktika më të mira për t'ju ndihmuar të filloni.

Kuptoni kufijtë e tokenëve

Lexoni udhëzuesin tonë për Token-at për të kuptuar më mirë se si të numëroni token-at dhe limitet e tyre.

Probleme të njohura

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

Paraqit një defekt

Bashkohuni në diskutim në forumin e zhvilluesve të inteligjencës artificiale të Google nëse keni pyetje.