Referenca e API-t Gemini

Kjo referencë API përshkruan API-të unare, të transmetimit dhe në kohë reale që mund të përdorni për të bashkëvepruar me modelet Gemini. Ju mund të përdorni API-të REST në çdo mjedis që mbështet kërkesat HTTP. Referojuni udhëzuesit "Fillimi" për mënyrën e fillimit me thirrjen tuaj të parë të API-t. Nëse po kërkoni referenca për bibliotekat dhe SDK-të tona specifike për gjuhën, shkoni te lidhja për atë gjuhë në navigimin e majtë nën referencat SDK .

Pikat kryesore të fundit

API-ja Gemini është e organizuar rreth pikave kryesore të mëposhtme:

• Ndërveprimet ( CreateInteraction ) (I rekomanduar): Primativi standard i rekomanduar për ndërtimin me Gemini, i optimizuar për rrjedhat e punës agjentike, menaxhimin e gjendjes nga ana e serverit dhe bisedat komplekse shumëmodale me shumë kthesa.
• Gjenerimi standard i përmbajtjes ( generateContent ): Një pikë fundore standarde REST që përpunon kërkesën tuaj dhe kthen përgjigjen e plotë të modelit në një paketë të vetme. Kjo është më e mira për detyrat jo-interaktive ku mund të prisni për rezultatin e plotë.
• Gjenerimi i përmbajtjes së transmetimit ( streamGenerateContent ): Përdor Ngjarjet e Dërguara nga Serveri (SSE) për t'ju dërguar pjesë të përgjigjes ndërsa ato gjenerohen. Kjo ofron një përvojë më të shpejtë dhe më interaktive për aplikacione si chatbot-et.
• Live API ( BidiGenerateContent ): Një API me gjendje statementale e bazuar në WebSocket për transmetim dypalësh, i projektuar për raste përdorimi bisedor në kohë reale.
• Modaliteti i serisë ( batchGenerateContent ): Një pikë fundore standarde REST për dërgimin e serive të kërkesave generateContent .
• Embeddings ( embedContent ): Një pikë fundore standarde REST që gjeneron një vektor të ngulitjes së tekstit nga Content hyrëse.
• API-të e Gen Media: Pikat fundore për gjenerimin e medias me modelet tona të specializuara si Imagen për gjenerimin e imazheve dhe Veo për gjenerimin e videove . Gemini gjithashtu ka këto aftësi të integruara, të cilat mund t'i qaseni duke përdorur API-në generateContent .
• API-të e platformës: Pikat fundore të shërbimeve që mbështesin aftësitë kryesore siç janë ngarkimi i skedarëve dhe numërimi i tokenëve .

Autentifikimi

Të gjitha kërkesat për Gemini API duhet të përfshijnë një kokë x-goog-api-key me çelësin tuaj API. Krijoni një me disa klikime në Google AI Studio .

Më poshtë është një shembull kërkese me çelësin API të përfshirë në kokë:

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

Për udhëzime se si ta kaloni çelësin tuaj te API duke përdorur SDK-të Gemini, shihni udhëzuesin Përdorimi i çelësave Gemini API .