Nisja e shpejtë e API-t Gemini

Ky udhëzues i shpejtë ju tregon se si të instaloni bibliotekat tona dhe të bëni kërkesën tuaj të parë Gemini API duke përdorur Interactions API.

Para se të filloni

Përdorimi i Gemini API kërkon një çelës API, mund ta krijoni një falas për të filluar.

Krijo një Çelës API Gemini

Instaloni SDK-në Google GenAI

Python

Duke përdorur Python 3.9+ , instaloni paketën google-genai duke përdorur komandën e mëposhtme pip :

pip install -q -U google-genai

JavaScript

Duke përdorur Node.js v18+ , instaloni SDK-në Google Gen AI për TypeScript dhe JavaScript duke përdorur komandën npm të mëposhtme:

npm install @google/genai

Bëni kërkesën tuaj të parë

Ja një shembull që përdor API-në e Ndërveprimeve për të dërguar një kërkesë te API-ja Gemini duke përdorur modelin Gemini 3 Flash.

Nëse e vendosni çelësin tuaj API si variablin e mjedisit GEMINI_API_KEY , ai do të merret automatikisht nga klienti kur përdor libraritë e API-t Gemini . Përndryshe, do t'ju duhet ta kaloni çelësin tuaj API si argument gjatë inicializimit të klientit.

Vini re se të gjitha mostrat e kodit në dokumentet e Gemini API supozojnë se ju keni vendosur variablin e mjedisit GEMINI_API_KEY .

Python

from google import genai

# The client gets the API key from the environment variable `GEMINI_API_KEY`.
client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3-flash-preview", 
    input="Explain how AI works in a few words"
)

# Print the model's text response
for step in interaction.steps:
    if step.type == "model_output":
        for content_block in step.content:
            if content_block.type == "text":
                print(content_block.text)

JavaScript

import { GoogleGenAI } from "@google/genai";

// The client gets the API key from the environment variable `GEMINI_API_KEY`.
const ai = new GoogleGenAI({});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3-flash-preview",
    input: "Explain how AI works in a few words",
  });

  const modelStep = interaction.steps.find(s => s.type === 'model_output');
  if (modelStep) {
    for (const contentBlock of modelStep.content) {
      if (contentBlock.type === 'text') console.log(contentBlock.text);
    }
  }
}

main();

PUSHTIM

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-flash-preview",
    "input": "Explain how AI works in a few words"
  }'

Çfarë vjen më pas

Tani që keni bërë kërkesën tuaj të parë API, mund të dëshironi të eksploroni udhëzuesit e mëposhtëm që tregojnë Gemini në veprim:

,

Nisja e shpejtë e API-t Gemini

Ky udhëzues i shpejtë ju tregon se si të instaloni bibliotekat tona dhe të bëni kërkesën tuaj të parë Gemini API duke përdorur Interactions API.

Para se të filloni

Përdorimi i Gemini API kërkon një çelës API, mund ta krijoni një falas për të filluar.

Krijo një Çelës API Gemini

Instaloni SDK-në Google GenAI

Python

Duke përdorur Python 3.9+ , instaloni paketën google-genai duke përdorur komandën e mëposhtme pip :

pip install -q -U google-genai

JavaScript

Duke përdorur Node.js v18+ , instaloni SDK-në Google Gen AI për TypeScript dhe JavaScript duke përdorur komandën npm të mëposhtme:

npm install @google/genai

Bëni kërkesën tuaj të parë

Ja një shembull që përdor API-në e Ndërveprimeve për të dërguar një kërkesë te API-ja Gemini duke përdorur modelin Gemini 3 Flash.

Nëse e vendosni çelësin tuaj API si variablin e mjedisit GEMINI_API_KEY , ai do të merret automatikisht nga klienti kur përdor libraritë e API-t Gemini . Përndryshe, do t'ju duhet ta kaloni çelësin tuaj API si argument gjatë inicializimit të klientit.

Vini re se të gjitha mostrat e kodit në dokumentet e Gemini API supozojnë se ju keni vendosur variablin e mjedisit GEMINI_API_KEY .

Python

from google import genai

# The client gets the API key from the environment variable `GEMINI_API_KEY`.
client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3-flash-preview", 
    input="Explain how AI works in a few words"
)

# Print the model's text response
for step in interaction.steps:
    if step.type == "model_output":
        for content_block in step.content:
            if content_block.type == "text":
                print(content_block.text)

JavaScript

import { GoogleGenAI } from "@google/genai";

// The client gets the API key from the environment variable `GEMINI_API_KEY`.
const ai = new GoogleGenAI({});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3-flash-preview",
    input: "Explain how AI works in a few words",
  });

  const modelStep = interaction.steps.find(s => s.type === 'model_output');
  if (modelStep) {
    for (const contentBlock of modelStep.content) {
      if (contentBlock.type === 'text') console.log(contentBlock.text);
    }
  }
}

main();

PUSHTIM

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-flash-preview",
    "input": "Explain how AI works in a few words"
  }'

Çfarë vjen më pas

Tani që keni bërë kërkesën tuaj të parë API, mund të dëshironi të eksploroni udhëzuesit e mëposhtëm që tregojnë Gemini në veprim: