Fillimi, Fillimi

Ky udhëzues ju orienton në fillim me Gemini API duke përdorur Interactions API . Do të kryeni thirrjen tuaj të parë të API-t në më pak se një minutë dhe do të eksploroni gjenerimin e tekstit, kuptimin multimodal, gjenerimin e imazheve, prodhimin e strukturuar, mjetet, thirrjen e funksioneve, agjentët dhe ekzekutimin në sfond.

API-ja e Ndërveprimeve është e disponueshme përmes SDK-ve të Python dhe JavaScript , si dhe përmes REST.

1. Merrni një çelës API

Për të përdorur Gemini API, duhet të keni një çelës API për të autentifikuar kërkesat tuaja, për të zbatuar kufijtë e sigurisë dhe për të ndjekur përdorimin e llogarisë suaj.

  • Google AI Studio krijon automatikisht një projekt dhe çelës API për përdoruesit e rinj. Mund ta kopjoni nga faqja e çelësave API .
  • Nëse ju nevojitet një çelës i ri, klikoni Krijo çelës API në AI Studio dhe ndiqni dialogun për të shtuar një çift të ri çelës-projekt.

Krijo një Çelës API Gemini

Vendosni çelësin tuaj si një ndryshore mjedisi:

export GEMINI_API_KEY="YOUR_API_KEY"

Përmirëso në nivelin me pagesë

Përmirësimi në nivelin me pagesë rrit kufijtë e tarifave dhe kërkon konfigurimin e Faturimit në Cloud.

  • Klikoni Konfiguro faturimin në çelësat API të AI Studio ose në faqet e Projekteve .
  • Ndiqni dialogun e Faturimit në Cloud për të krijuar ose lidhur një llogari faturimi, për të shtuar një metodë pagese dhe për të parapaguar një minimum prej 5 dollarësh (ose ekuivalentin e monedhës) në kredite të paguara.
  • Shikoni përdorimin e API-t tuaj në Google AI Studio nën Paneli > Përdorimi .

Shihni faqen e Faturimit për më shumë informacion.

2. Instaloni SDK-në dhe bëni thirrjen tuaj të parë

Instaloni SDK-në dhe gjeneroni tekst me një thirrje të vetme API-je.

Python

Instaloni SDK-në:

pip install -U google-genai

Inicializoni klientin dhe bëni një kërkesë:

from google import genai

client = genai.Client()

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

JavaScript

Instaloni SDK-në:

npm install @google/genai

Inicializoni klientin dhe bëni një kërkesë:

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

const ai = new GoogleGenAI({});

const interaction = await ai.interactions.create({
  model: "gemini-3.8-flash",
  input: "Explain how AI works in a few words",
});
console.log(interaction.output_text);

Java 

import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;

Client client = new Client();

CreateModelInteraction params =
    CreateModelInteraction.builder()
        .model(Model.of("gemini-3.8-flash"))
        .input(InteractionsInput.of("Explain how AI works in a few sentences."))
        .build();

Interaction interaction =
    client.interactions.create(CreateInteractionRequestBody.of(params)).interaction().get();

System.out.println(interaction.outputText().orElse(""));

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

Përgjigje:

{
  "id": "v1_ChdpQUFvYXI...",
  "status": "completed",
  "usage": {
    "total_tokens": 197,
    "total_input_tokens": 8,
    "total_output_tokens": 12
  },
  "created": "2026-06-09T12:01:25Z",
  "steps": [
    {
      "type": "thought",
      "signature": "EvEFCu4FAQw..."
    },
    {
      "type": "model_output",
      "content": [
        {
          "type": "text",
          "text": "AI learns patterns from data, then uses those patterns to make predictions or decisions on new data."
        }
      ]
    }
  ],
  "object": "interaction",
  "model": "gemini-3.8-flash",
}

Kur përdoret REST, API kthen burimin e plotë Interaction që përmban meta të dhëna, statistika përdorimi dhe historikun hap pas hapi të kthesës.

Ndërkohë që SDK-të e ekspozojnë përgjigjen e plotë, ato ofrojnë gjithashtu veti të përshtatshme si interaction.output_text dhe interaction.output_image për të aksesuar drejtpërdrejt rezultatet përfundimtare. Mësoni më shumë rreth strukturës së përgjigjes në përmbledhjen e Ndërveprimeve ose lexoni udhëzuesin e gjenerimit të tekstit për detaje mbi udhëzimet e sistemit dhe konfigurimin e gjenerimit.

3. Transmetoni përgjigjen

Për ndërveprime më fluide, transmetoni përgjigjen ndërsa gjenerohet. Çdo ngjarje step.delta ofron një pjesë teksti që mund ta shfaqni menjëherë.

Python 

from google import genai

client = genai.Client()

stream = client.interactions.create(
    model="gemini-3.8-flash",
    input="Explain how AI works",
    stream=True
)
for event in stream:
    print(event)

JavaScript 

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

const ai = new GoogleGenAI({});

const stream = await ai.interactions.create({
  model: "gemini-3.8-flash",
  input: "Explain how AI works",
  stream: true,
});

for await (const event of stream) {
  console.log(event);
}

Java 

import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;

Client client = new Client();

CreateModelInteraction params =
    CreateModelInteraction.builder()
        .model(Model.of("gemini-3.8-flash"))
        .input(InteractionsInput.of("Explain how AI works in a few sentences."))
        .build();

Interaction interaction =
    client.interactions.create(CreateInteractionRequestBody.of(params)).interaction().get();

System.out.println(interaction.outputText().orElse