Arendaja platvorm

Gemini API

Google DeepMind ülevaade arendajatele, mis hõlmab API-juurdepääsu, hinnastust, SDK-tuge, lõppunkte, võimekusi ja platvormi reegleid.

Dokumentatsioon API juhend

API võti Nõutud

Peamine API Interactions API

SDK tugi Ametlikud Google GenAI SDK-d Pythonile, JavaScriptile/TypeScriptile, Go-le ja Javale. Toetatud on ka REST. Google soovitab pärandatud Gemini SDK-delt üle minna Google GenAI SDK-le.

Päringupiirangud Projektitaseme piirangud hõlmavad tavaliselt päringute arvu minutis, sisendtokenite arvu minutis ja päringute arvu päevas. Piirangud sõltuvad mudelist ja kasutustasemest ning neid saab vaadata Google AI Studios. Pakktöötluspäringutele kehtivad eraldi kvoo

Platvorm

API ülevaade

Lõppunktid (endpoints)

API ligipääs

Juuraadress (Base URL)


					https://generativelanguage.googleapis.com

Peamine API Interactions API

Hinnad

API Hinnad

Hinnakujundusmudel Tasuta pakett ning ettemaksupõhised ja kasutuspõhise hinnastamisega tasulised paketid; kasutust arvestatakse peamiselt mudeli, sisendtokenite, väljundtokenite, vahemällu salvestatud tokenite, säilitusaja, teenusetaseme, partiirežiimi ja tööriistade kasutu

Tasuta juurdepääs on saadaval valitud mudelitele ja kehtestatud limiitide piires. Tasuline juurdepääs pakub suuremaid limiite, täiustatud mudeleid, konteksti vahemällu salvestamist, paketttöötlust ja tootmiskasutuseks mõeldud funktsioone. Kehtivad hinnad sõltuvad mudelist ning on toodud ametlikul hinnalehel.

Arendaja töömugavus

SDK info

SDK Ametlikud Google GenAI SDK-d Pythonile, JavaScriptile/TypeScriptile, Go-le ja Javale. Toetatud on ka REST. Google soovitab pärandatud Gemini SDK-delt üle minna Google GenAI SDK-le.

Kasutusmugavus Kõrge. Google pakub AI Studiot, API-võtmete loomist, kiirstarte, REST-i näiteid ja ametlikke tootmiskasutuseks valmis SDK-sid. Soovitatud Interactions API pakub ühtset mudeli- ja agendiliidest.

Dokumentatsioon Põhjalik ja ulatuslik, sisaldades ajakohaseid kiirjuhendeid, API viitedokumentatsiooni, migratsioonijuhiseid, SDK dokumentatsiooni, võimaluste juhendeid, hinnateavet, päringumäärade piiranguid ning dokumentatsiooni failide, agentide ja privaatsuse kohta.

Viivitus Gemini otse-API puhul ei ole universaalset viiteaja garantiid. Viiteaeg sõltub mudelist, viibast ja väljundi suurusest, piirkonnast, koormusest, tööriistadest ning teenusetasemest. API pakub võimaluse korral standardset, prioriteetset ja muid mudelist sõl

Allikad

Viited arendajale

Dokumentatsioon ↗ API juhend ↗ Liivakast ↗

Featuurid

API võimekused

✓ Voogedastus

✓ Funktsioonide kasutamine

✓ Assistants API

✓ Failide üleslaadimine

✓ Veebiotsing

✓ Pildi sisend

✓ Struktureeritud väljund

✓ Liivakast

Lühikirjeldus

Seisuga 26. september 2026 dokumenteerib Google Interactions API-d kui uute Gemini API projektide jaoks soovitatavat liidest ja märgib, et see on üldiselt kättesaadav. Algne generateContent API on endiselt toetatud, kuid uute projektide puhul käsitatakse seda pärandliidesena. Interactions API toetab mudelite kutsumist, mitmeliigilist sisu, voogedastust, serveripoolset vestluse olekut parameetri previous_interaction_id kaudu, struktureeritud väljundit parameetri response_format kaudu, funktsioonikutsungeid, sisseehitatud tööriistu, taustal täitmist ja hallatavaid agente. Hallatavad agendid, sealhulgas Antigravityl põhinevad agendid ja Deep Researchi agendid, on praegu eelvaatefunktsioonid. Files API toetab teksti, pilte, heli, videot ja dokumente, kuid kehtivad mudelist ja lõpp-punktist sõltuvad piirangud. Gemini API otsene peenhäälestus ei ole praegu saadaval, kuigi toetatud konfiguratsioonide puhul on häälestamine endiselt võimalik Gemini Enterprise Agent Platformi kaudu. Arendajaplatvorm toetab pildisisendit ja struktureeritud väljundit, kuid täpne tugi sõltub valitud mudelist ja lõpp-punktist.

Näited

API Näited

# Basic Interactions API request
curl -sS -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",
    "system_instruction": "You are a concise technical assistant.",
    "input": "Explain server-side streaming in one paragraph."
  }' | jq -r '.steps[]?.content[]?.text // empty'

# Structured JSON output
curl -sS -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": "Extract the product and year from: Google released Gemini in 2023.",
    "response_format": {
      "type": "text",
      "mime_type": "application/json",
      "schema": {
        "type": "object",
        "properties": {
          "product": {"type": "string"},
          "year": {"type": "integer"}
        },
        "required": ["product", "year"]
      }
    }
  }' | jq -r '.steps[]?.content[]?.text // empty'

# Streaming request
curl -N -sS -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":"Write a short welcome message.","stream":true}'

# Install: pip install -U google-genai pydantic
import os
from google import genai
from pydantic import BaseModel

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

# Basic request with system instruction
interaction = client.interactions.create(
    model="gemini-3.8-flash",
    system_instruction="You are a helpful technical assistant.",
    input="Explain APIs in two sentences.",
)
print(interaction.output_text)

# Multi-turn conversation using server-side interaction state
follow_up = client.interactions.create(
    model="gemini-3.8-flash",
    previous_interaction_id=interaction.id,
    input="Now give one practical example.",
)
print(follow_up.output_text)

# Streaming
stream = client.interactions.create(
    model="gemini-3.8-flash",
    input="List three benefits of structured output.",
    stream=True,
)
for event in stream:
    if getattr(event, "type", None) == "content_delta":
        print(getattr(event, "delta", ""), end="", flush=True)
print()

# Structured JSON output
class Contact(BaseModel):
    name: str
    email: str

structured = client.interactions.create(
    model="gemini-3.8-flash",
    input="Extract the contact from: Ada Lovelace, ada@example.com",
    response_format={
        "type": "text",
        "mime_type": "application/json",
        "schema": Contact.model_json_schema(),
    },
)
contact = Contact.model_validate_json(structured.output_text)
print(contact.name, contact.email)

# File input
uploaded = client.files.upload(file="document.pdf")
file_interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input=[
        {"type": "text", "text": "Summarize this document."},
        {"type": "document", "uri": uploaded.uri, "mime_type": uploaded.mime_type},
    ],
)
print(file_interaction.output_text)

// Install: npm install @google/genai
import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });

async function main() {
  try {
    const interaction = await ai.interactions.create({
      model: "gemini-3.8-flash",
      system_instruction: "You are a helpful technical assistant.",
      input: "Explain APIs in two sentences.",
    });
    console.log(interaction.output_text);

    const followUp = await ai.interactions.create({
      model: "gemini-3.8-flash",
      previous_interaction_id: interaction.id,
      input: "Now give one practical example.",
    });
    console.log(followUp.output_text);

    const stream = await ai.interactions.create({
      model: "gemini-3.8-flash",
      input: "Write a short welcome message.",
      stream: true,
    });
    for await (const event of stream) {
      if (event.type === "content_delta") process.stdout.write(event.delta ?? "");
    }
    process.stdout.write("\n");

    const structured = await ai.interactions.create({
      model: "gemini-3.8-flash",
      input: "Return the status as JSON for a completed job.",
      response_format: {
        type: "text",
        mime_type: "application/json",
        schema: {
          type: "object",
          properties: {
            status: { type: "string" },
            completed: { type: "boolean" }
          },
          required: ["status", "completed"]
        }
      }
    });
    console.log(JSON.parse(structured.output_text));
  } catch (error) {
    console.error(error);
    process.exitCode = 1;
  }
}

main();

<?php
$apiKey = getenv('GEMINI_API_KEY');
if (!$apiKey) {
    throw new RuntimeException('GEMINI_API_KEY is not set');
}

$url = 'https://generativelanguage.googleapis.com/v1beta/interactions';
$payload = [
    'model' => 'gemini-3.8-flash',
    'system_instruction' => 'You are a helpful technical assistant.',
    'input' => 'Explain APIs in two sentences.',
];

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'x-goog-api-key: ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($payload, JSON_THROW_ON_ERROR),
    CURLOPT_TIMEOUT => 60,
]);

$responseBody = curl_exec($ch);
if ($responseBody === false) {
    throw new RuntimeException('cURL error: ' . curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$data = json_decode($responseBody, true, 512, JSON_THROW_ON_ERROR);
if ($statusCode < 200 || $statusCode >= 300) {
    $message = $data['error']['message'] ?? 'Gemini API request failed';
    throw new RuntimeException($message, $statusCode);
}

$text = '';
foreach (($data['steps'] ?? []) as $step) {
    foreach (($step['content'] ?? []) as $content) {
        if (($content['type'] ?? null) === 'text') {
            $text .= $content['text'] ?? '';
        }
    }
}

echo $text . PHP_EOL;
?>

Põhimõtted

Andmete kasutus

Gemini API tasuta paketi puhul märgib Google, et sisu võidakse kasutada Google’i toodete täiustamiseks. Tasulise Gemini API kasutuse kohta öeldakse, et seda ei kasutata Google’i toodete täiustamiseks. Gemini Enterprise’i juurutustele Gemini Enterprise Agent Platformil kehtivad eraldi lepingulised kontrollimehhanismid ning Google’i sõnul ei kasutata kliendiandmeid hallatavate mudelite treenimiseks ega peenhäälestamiseks ilma eelneva loata või juhiseta, võttes arvesse kohaldatavaid teenusetingimusi.

Andmete säilitamine

Gemini Files API kaudu üles laaditud faile säilitatakse 48 tundi ning kasutajad ei saa neid üldjuhul pärast üleslaadimist alla laadida, kuigi genereeritud failide allalaadimine võib toimida eraldi reeglite alusel. Interactions API salvestab päringud vaikimisi, et toetada parameetrit previous_interaction_id ja serveripoolset olekut. Hallatavate agentide keskkonnad võivad interaktsioonide vahel säilida ning need kustutatakse jäädavalt pärast seitset tegevusetut päeva. Ettevõtetele mõeldud Gemini juurutused pakuvad säilitamise, andmete asukoha ja nullandmete säilitamise kontrolle, mis sõltuvad konfiguratsioonist ja kohaldatavatest Google Cloudi tingimustest.

Päringupiirangud

Projektitaseme piirangud hõlmavad tavaliselt päringute arvu minutis, sisendtokenite arvu minutis ja päringute arvu päevas. Piirangud sõltuvad mudelist ja kasutustasemest ning neid saab vaadata Google AI Studios. Pakktöötluspäringutele kehtivad eraldi kvoo

Arendaja juhend

Google Gemini API juhend: kuidas alustada Interactions API kasutamist

Google Gemini API on arendajatele mõeldud platvorm Gemini mudelitega rakenduste loomiseks. Uute projektide puhul on praegu soovitatav kasutada Interactions API-t, mis toetab multimodaalset sisendit, voogedastust, struktureeritud JSON-vastuseid, funktsioonikutseid, sisseehitatud tööriistu, failisisendit, vestluse olekut ja hallatavaid agente. Selles juhendis käsitletakse juurdepääsu, autentimist, SDK-sid, päringuid, hinnastamist, võimalusi, piiranguid ja tootmiskeskkonnaga seotud kaalutlusi.

Google’i Gemini API annab arendajatele Google AI Studio, REST-i ja ametlike Google GenAI SDK-de kaudu otsejuurdepääsu Gemini mudelitele. Uute rakenduste puhul tuleks üldjuhul kasutada Interactions API-t, sest see koondab mudelikutsed, multimodaalse sisu, voogedastuse, tööriistad, struktureeritud väljundi, mitme pöördega oleku ja agentide töövood ühte liidesesse. Algne generateContent API on olemasolevate rakenduste ja otsese olekuta genereerimise jaoks endiselt toetatud, kuid uute projektide puhul ei ole see eelistatud lähtekoht.

Gemini API annab arendajatele Google AI Studio, REST-i ja ametlike Google GenAI SDK-de kaudu otsese juurdepääsu Gemini mudelitele. Soovitatav Interactions API toetab multimodaalseid sisendeid, voogedastust, struktureeritud JSON-i, funktsioonikutseid, sisseehitatud tööriistu, failianalüüsi, vestluse olekut ja eelvaates hallatavaid agente. Juhend käsitleb autentimist, esimesi päringuid, hinnastamist, piiranguid, privaatsust ja tootmiskasutuse kavandamist.

Mis on Gemini API ja millal seda kasutada

Gemini API on Google'i arendajatele mõeldud otseplatvorm Gemini mudelite rakendustesse integreerimiseks. See võimaldab tarkvaral saata valitud mudelile viipasid ja faile, saada genereeritud vastuseid ning ühendada mudeli arutluskäigu rakenduse koodiga tööriistade ja funktsioonikutsete kaudu.

Erinevalt tavakasutajatele mõeldud Gemini rakendustest on API suunatud arendajatele, kes loovad oma tooteid, teenuseid, automatiseeritud töövooge, uurimistööriistu ja ettevõttesiseseid lahendusi. See toetab teksti genereerimist ning piltide, heli, video ja dokumentide mõistmist, kui valitud mudel ja lõpp-punkt neid sisendeid toetavad.

Uute projektide puhul soovitab Google kasutada Interactions API-t. See pakub mudelikutsungite ja hallatavate agenditöövoogude jaoks ühist päringuvormingut, sealhulgas voogedastust, struktureeritud vastuseid, sisseehitatud tööriistu, funktsioonikutseid ja serveripoolset mitmevoorulist olekut previous_interaction_id kaudu. Vanem generateContent liides on endiselt toetatud ning võib olla kasulik otsese olekuta genereerimise või olemasoleva koodiga ühilduvuse korral.

Kuidas saada juurdepääs ja luua API-võti

Gemini API päringud nõuavad API-võtit. Google AI Studio on enamiku arendajate jaoks kõige lihtsam lähtekoht: see pakub visuaalset tööruumi, projektide ja võtmete haldust, mudelite testimist, kasutuse jälgimist ning agentide prototüüpimist.

Avage Google AI Studio ning looge projekt või valige olemasolev projekt.
Looge projekti jaoks API-võti.
Salvestage võti keskkonnamuutujasse, näiteks GEMINI_API_KEY.
Kasutage võtit serveripoolses rakenduses, SDK-s või REST-päringus.

Ärge paigutage API-võtit brauserikoodi, mobiilirakenduse paketti, avalikku koodihoidlasse ega kliendipoolsesse JavaScripti, mida kasutajad saavad kontrollida. Kasutage võtme kaitsmiseks taustateenust või saladuste haldurit. REST-päringutes saadetakse võti tavaliselt päises x-goog-api-key.

Liidese ja mudeli valimine

Alustage mudeli valimisest, mis vastab rakenduse ülesandele, sisenditüüpidele, latentsusnõuetele ja eelarvele. Mudelite kättesaadavus ja täpne funktsioonitugi võivad erineda, seega kontrollige enne juurutamist kehtivat mudelidokumentatsiooni.

Interactions API on uute rakenduste jaoks soovitatav üldotstarbeline liides. See on eriti kasulik siis, kui rakendus vajab vestluse olekut, voosündmusi, tööriistu, struktureeritud vastuseid või agendi käitamist. Kasutage algset generateContent API-t ainult siis, kui selle olekuta päringuvorming sobib paremini või kui hooldate olemasolevat integratsiooni.

Mudeli nimi edastatakse igas päringus. Allolevates näidetes kasutatakse väärtust gemini-3.8-flash, mis vastab esitatud ajakohasele API-uuringule. Asendage see projektis saadaoleva ja vajalike võimalustega mudeliga.

Esimese päringu tegemine

Installige praegune Google GenAI SDK, mitte vanem pärandvara Gemini klienditeek. Pythoni projektides kasutatakse google-genai, JavaScripti ja TypeScripti projektides aga @google/genai. Ametlikud teostused on saadaval ka Go ja Java jaoks.

Pythoni näide

pip install -U google-genai

import os
from google import genai

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    system_instruction="You are a helpful technical assistant.",
    input="Explain APIs in two sentences.",
)

print(interaction.output_text)

JavaScripti näide

npm install @google/genai

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

const ai = new GoogleGenAI({
  apiKey: process.env.GEMINI_API_KEY
});

const interaction = await ai.interactions.create({
  model: "gemini-3.8-flash",
  system_instruction: "You are a helpful technical assistant.",
  input: "Explain APIs in two sentences."
});

console.log(interaction.output_text);

SDK näidetes kasutatakse läbivalt sama praegust klienti ja meetodite perekonda: GoogleGenAI või genai.Client koos väärtusega interactions.create. REST on samuti saadaval, kui rakendus vajab otseseid HTTP-päringuid või ei kasuta ametlikku SDK-d.

Vastuse mõistmine

Interaktsioon võib sisaldada väljundteksti ja täitmisetappe. Lihtsa päringu korral on SDK output_text-atribuut mugav viis genereeritud teksti kättesaamiseks. Tööriistu või hallatavaid agente kasutavad rakendused võivad uurida üksikuid etappe, et mõista tööriistakutseid, vahesündmusi ja tagastatud sisu.

Ärge eeldage, et genereeritud tekst on automaatselt usaldusväärne või käivitamiseks ohutu. Kontrollige andmeid, rakendage tööriistadele autoriseerimiskontrolle ja käsitlege vigu enne vastuse kasutamist äriprotsessis. Struktureeritud väljund võib muuta sõelumise prognoositavamaks, kuid ei kaota vajadust rakendusepõhise valideerimise järele.

Kuidas Gemini API hinnastamine toimib

Gemini API-l on sobivate mudelite ja kasutustasemete jaoks tasuta pakett, millele järgneb tootmiskoormuste puhul tasuline kasutus. Tasuline kasutus sõltub üldjuhul järgmistest teguritest:

Mudelile saadetud sisendmärgid.
Modelli genereeritud väljundmärgid.
Puhverdatud märgid ja nende salvestamine.
Valitud mudel.
Teenusetase.
Pakitöötlus.
Tööriistade kasutus, kui see on kohaldatav.

Google pakub ka pakitöötlust, konteksti vahemällu salvestamist, prioriteetseid teenusetasemeid ja täiendavate juhtelementidega ettevõttelahendusi. Hinnad erinevad mudeliti ja võivad muutuda, seega kasutage rakenduse või eelarve koostamisel eeldatavate hindade sisestamise asemel alati kehtivat ametlikku hinnadokumentatsiooni.

Ka tasuta paketi tingimused on andmehalduse seisukohast olulised: Google'i sõnul võidakse Gemini API tasuta paketi sisu kasutada toodete täiustamiseks. Tasulise Gemini API kasutuse kohta öeldakse, et seda ei kasutata Google'i toodete täiustamiseks. Ettevõtete Gemini juurutustel on eraldi lepingulised ja andmehalduse tingimused.

Mida saavad arendajad API-ga luua

Multimodaalne sisend

Gemini suudab töödelda teksti, pilte, heli, videot ja dokumente, lähtudes mudeli ja lõpp-punkti piirangutest. See võimaldab luua näiteks dokumentide analüüsi, piltide tõlgendamise, heli või video mõistmise ning mitut sisenditüüpi ühendavaid töövooge.

Väikesed sisendid saab lisada otse päringusse. Suuremate failide või mitmes päringus kasutatavate failide puhul kasutage Files API-t. Üleslaaditud faile saavad kasutada toetatud mudelid ning neid säilitatakse 48 tundi. Dokumenteeritud piirangud on kuni 2 GB faili kohta ja 20 GB failisalvestusruumi projekti kohta.

Vastuste voogedastus

Voogedastus saadab mudeli vastuse genereerimise ajal järk-järgult sündmusi, selle asemel et oodata täieliku tulemuse valmimist. See on kasulik vestlusliideste, edenemisnäitude ja rakenduste puhul, kus kasutajad peaksid nägema väljundit selle tekkimise ajal.

const stream = await ai.interactions.create({
  model: "gemini-3.8-flash",
  input: "Write a short welcome message.",
  stream: true
});

for await (const event of stream) {
  if (event.type === "content_delta") {
    process.stdout.write(event.delta ?? "");
  }
}
process.stdout.write("n");

Live API pakub sobivate hääl- ja multimodaalsete kasutuskogemuste jaoks kahesuunalist reaalajas voogedastust. Selle kättesaadavus ning toetatud sisendi- ja väljundikombinatsioonid sõltuvad asjakohase mudeli ja funktsiooni dokumentatsioonist.

Funktsioonikutsed ja sisseehitatud tööriistad

Funktsioonikutsed võimaldavad mudelil taotleda rakenduse määratud toimingu tegemist. Näiteks võib mudel taotleda ilmaandmete päringut või andmebaasiotsingut, mille järel rakendus funktsiooni käivitab ja tulemuse tagasi saadab. Mudel ei saa automaatselt luba suvaliste toimingute tegemiseks; rakendus määrab, millised funktsioonid on olemas ja kas iga kutse on lubatud.

Gemini toetab ka sisseehitatud tööriistu, näiteks Google Searchi, URL-i konteksti, koodi käivitamist ja failiotsingut. Tööriistade kättesaadavus sõltub mudelist ja sellest, kas funktsioon on eelvaates. Tootmissüsteemid peaksid tööriistade argumente valideerima, jõustama autoriseerimise, määrama ajalõpud ning salvestama tööriistade vead mudeli väljundist eraldi.

Struktureeritud JSON-väljund

Struktureeritud väljund võimaldab rakendusel esitada JSON Schema ja taotleda sellele vastavat vastust. See on kasulik siis, kui genereeritud teave tuleb edastada teisele programmile, mitte ainult kuvada proosatekstina.

from pydantic import BaseModel
from google import genai
import os

class Contact(BaseModel):
    name: str
    email: str

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

result = client.interactions.create(
    model="gemini-3.8-flash",
    input="Extract the contact from: Ada Lovelace, ada@example.com",
    response_format={
        "type": "text",
        "mime_type": "application/json",
        "schema": Contact.model_json_schema(),
    },
)

contact = Contact.model_validate_json(result.output_text)
print(contact.name, contact.email)

Interactions API kasutab tipptaseme välja response_format koos tekstivormingu, application/json MIME-tüübi ja skeemiga. Ametlikud SDK-d toetavad skeemimääratlusi standardsete sõnastike, Pythoni Pydantici mudelite ja JavaScriptis JSON-Schema-ga ühilduvate lähenemisviiside kaudu. Valideerige tulemus enne selle salvestamist või järgnevates toimingutes kasutamist.

Mitmevooruline olek ja agendid

Rakendused saavad interaktsiooni jätkata, edastades eelmise interaktsiooni identifikaatori:

follow_up = client.interactions.create(
    model="gemini-3.8-flash",
    previous_interaction_id=interaction.id,
    input="Now give one practical example.",
)

print(follow_up.output_text)

See serveripoolne olek on mitmevooruliste töövoogude puhul mugav, kuid mõjutab ka säilitamise ja andmehalduse otsuseid. Interactions API salvestab päringud vaikimisi, et seda olekupõhist töövoogu toetada.

Hallatavad agendid on saadaval avalikus eelvaates. Need võivad töötada isoleeritud Linuxi liivakastikeskkondades, käivitada koodi, hallata faile, sirvida veebi ja kasutada konfigureeritud tööriistu. Arendajad saavad käivitada eelmääratletud agente või luua agente püsivate juhiste, oskuste, failide ja võrgureeglitega. Eelvaate skeemid ja käitumine võivad muutuda, seega vältige pöördumatu tootmissõltuvuse loomist dokumenteerimata agendi käitumisele.

Failide üleslaadimine ja analüüsimine

Files API toetab korduvkasutatavaid teksti-, pildi-, heli-, video- ja dokumendisisendeid, lähtudes mudelipõhistest piirangutest. Tüüpilises töövoos laaditakse fail üles ja edastatakse seejärel selle URI interaktsioonile:

uploaded = client.files.upload(file="document.pdf")

file_interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input=[
        {"type": "text", "text": "Summarize this document."},
        {
            "type": "document",
            "uri": uploaded.uri,
            "mime_type": uploaded.mime_type
        },
    ],
)

print(file_interaction.output_text)

Gemini Files API kaudu üles laaditud faile säilitatakse 48 tundi. Kavandage töövood seda säilitusaega arvestades ja laadige fail uuesti üles, kui seda on vaja hiljem töödelda.

Piirangud ja tootmiskasutuse kaalutlused

Piiranguid rakendatakse projekti tasemel ning need hõlmavad tavaliselt päringuid minutis, sisendmärke minutis ja päringuid päevas. Täpsed väärtused sõltuvad mudelist ning arvelduse või kasutuse tasemest ja neid saab vaadata Google AI Studios.

Pakitöötlusel on eraldi dokumenteeritud piirangud, sealhulgas kuni 100 samaaegset pakipäringut, 2 GB sisendfaili piirang ja 20 GB projektipõhine failisalvestuse piirang. Neid näitajaid tuleks enne mahu planeerimist võrrelda kehtiva dokumentatsiooniga.

Kaitske mandaate: hoidke API-võtmeid serveris ning vahetage või tühistage avalikuks saanud võtmed.
Käsitlege ajutisi tõrkeid: rakendage piiratud korduskatseid koos viivitusega sageduspiirangu ja ajutiste teenusetõrgete korral.
Kontrollige kulusid: kasutage projektikvoote, arveldusjuhtelemente ning sobivaid mudeleid või teenusetasemeid.
Valideerige väljundeid: sõeluge ja valideerige struktureeritud vastused enne nende kasutamist rakenduse loogikas.
Minimeerige tundlike andmete logimist: päringu identifikaatorid ja kasutusmetaandmed on sageli kasulikumad kui täielike viipade ja vastuste salvestamine.
Planeerige säilitamist: arvestage Files API säilitusaja, Interactions API oleku ja hallatavate agentide keskkondade elueaga.
Kontrollige piirkondlikku kättesaadavust: mudelite juurdepääs, piirangud, tööriistad ja ettevõttelahendused võivad asukohast ja konto konfiguratsioonist sõltuvalt erineda.

Gemini API-l ei ole üht kindlat latentsusnäitajat. Vastuse kiirus sõltub mudelist, viiba suurusest, genereeritud väljundist, piirkonnast, liiklusest, tööriistadest ja teenusetasemest. Rangete latentsus- või läbilaskevusnõuetega rakendused peaksid testima oma töökoormust ning hindama toetatud teenusetasemeid, kvoote, piirkondlikku kättesaadavust ja ettevõtte juurutusvõimalusi.

Peenhäälestus ja andmepoliitika

Otsene peenhäälestus ei ole praegu Gemini API ega Google AI Studio kaudu saadaval. Viimane toetatud Gemini API peenhäälestusmudel Gemini 1.5 Flash-001 aegus 2025. aasta mais. Peenhäälestus on toetatud mudelite ja konfiguratsioonide puhul endiselt saadaval Google'i ettevõtteplatvormi kaudu.

Säilitamine ja andmete kasutamine treenimiseks sõltuvad API paketist ja funktsioonist. Tasuta paketi sisu võidakse kasutada Google'i toodete täiustamiseks, samas kui tasulise Gemini API kasutuse kohta öeldakse, et seda sel eesmärgil ei kasutata. Ettevõttelahendustel on eraldi tingimused ja andmehalduse juhtelemendid. Enne konfidentsiaalse, reguleeritud või varalise teabe saatmist vaadake üle kehtivad kohaldatavad teenusetingimused.

Millal on Gemini API hea või halb valik

Gemini API on hea valik siis, kui rakendus vajab Google'i toetatud multimodaalset platvormi koos ametlike SDK-de, Google AI Studio, voogedastuse, struktureeritud väljundi, funktsioonikutsete, failianalüüsi, Google Searchi või muude sisseehitatud tööriistadega ning ühtset teed olekupõhiste interaktsioonide ja hallatavate agentideni. See on praktiline valik ka meeskondadele, kes kasutavad juba Google'i teenuseid või hindavad Gemini mudeleid Google'i arendajatööriistade kaudu.

See võib olla halb valik siis, kui projekt nõuab fikseeritud ja muutumatut mudeliliidest, garanteeritult deterministlikke vastuseid, piiramatut juurdepääsu kõigile võimalustele või täielikku sõltumatust Google'i konto-, teenuse- ja andmehalduse ökosüsteemist. Hindamisel tuleb arvestada tasuta paketi andmekasutuse tingimusi, funktsioonide ja mudelite kättesaadavust, eelvaate-API-sid, projektikvoote, failide säilitusaega ning muutuvaid mudelihindu.

Uue rakenduse puhul on mõistlik alustada kaitstud API-võtme loomisest Google AI Studios, praeguse Google GenAI SDK installimisest, väikese Interactions API päringu tegemisest ning struktureeritud väljundi või voogedastuse lisamisest ainult vajaduse korral. Seejärel testige valitud mudelit ja töökoormust projekti kulude, latentsuse, privaatsuse ja töökindluse nõuete suhtes.

Allikad 16