Referenca e Gemini API

Kjo referencë e API-së përshkruan API-të unare, të transmetimit dhe në kohë reale që mund të përdorësh për të ndërvepruar me modelet e Gemini. Mund të përdorësh REST API në çdo mjedis që mbështet kërkesat HTTP. Referoju Udhëzuesit për fillimin për mënyrën se si të fillosh me thirrjen tënde të parë të API-së. Nëse po kërkon referencat për bibliotekat dhe SDK-të tona specifike për gjuhën, shko te lidhja për atë gjuhë në navigimin majtas nën Referencat e SDK-së.

Pikat përfundimtare kryesore

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

  • Interactions (CreateInteraction) (rekomandohet): Primitivi standard i rekomanduar për ndërtimin me Gemini, i optimizuar për flukset e punës me agjentë, menaxhimin e gjendjes në anën e serverit dhe bisedat komplekse shumëmodale me shumë bashkëbisedues.
  • Gjenerimi standard i përmbajtjes (generateContent): Një pikëfundore standarde REST që përpunon kërkesën tënde dhe kthen përgjigjen e plotë të modelit në një paketë të vetme. Kjo është më e mira për detyrat jointeraktive ku mund të presësh për të gjithë rezultatin.
  • Gjenerimi i përmbajtjes së transmetimit (streamGenerateContent): Përdor Server-Sent Events (SSE) për të të dërguar pjesë të përgjigjes ndërkohë që ato gjenerohen. Kjo ofron një përvojë më të shpejtë dhe më ndërvepruese për aplikacionet si robotët e bisedës.
  • Live API (BidiGenerateContent): Një API me gjendje i bazuar në WebSocket për transmetimin dydrejtimësh, i projektuar për raste përdorimi bisedore në kohë reale.
  • Modaliteti i grupit (batchGenerateContent): Një pikë fundore standarde REST për dërgimin e grupeve të kërkesave të generateContent.
  • Integrimet (embedContent): Një pikëfundore standarde REST që gjeneron një vektor të integrimit të tekstit nga hyrja Content.
  • API-të e Gen Media: Pikat fundore për gjenerimin e medias me modelet tona të specializuara, si p.sh. Imagen për gjenerimin e imazheve dhe Veo për gjenerimin e videove. Gemini ka gjithashtu të integruara këto aftësi, të cilat mund t'i qasesh duke përdorur generateContent API.
  • API-të e platformës: Pikat fundore të shërbimeve që mbështesin aftësitë kryesore si p.sh. ngarkimi i skedarëve dhe numërimi i tokenëve.

Vërtetim

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

Më poshtë është një kërkesë shembull me çelësin e API-së të përfshirë në kokë:

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.8-flash",
    "input": "Explain how AI works in a few words"
  }'

Për udhëzime se si të kalosh çelësin tënd te API duke përdorur SDK-të e Gemini, shiko udhëzuesin Përdorimi i çelësave të Gemini API.