Krótkie wprowadzenie do Gemini API

Z tego krótkiego wprowadzenia dowiesz się, jak zainstalować nasze biblioteki i utworzyć pierwsze żądanie do interfejsu Gemini API za pomocą interfejsu Interactions API.

Zanim zaczniesz

Aby korzystać z interfejsu Gemini API, musisz mieć klucz interfejsu API, który umożliwia uwierzytelnianie żądań, egzekwowanie limitów bezpieczeństwa i śledzenie wykorzystania na koncie.

Aby rozpocząć, utwórz go bezpłatnie w AI Studio:

Tworzenie klucza interfejsu Gemini API

Instalowanie pakietu Google GenAI SDK

pip install -q -U google-genai

npm install @google/genai

Prześlij pierwszą prośbę

Żądanie do interfejsu Gemini API możesz wysłać na 2 sposoby:

• (Zalecane) Interfejs Interactions API to nowy element podstawowy z natywną obsługą wieloetapowego korzystania z narzędzi, orkiestracji i złożonych procesów rozumowania za pomocą wpisywanych kroków wykonywania. W przyszłości nowe modele spoza głównej rodziny, a także nowe funkcje i narzędzia oparte na agentach będą udostępniane wyłącznie w interfejsie Interactions API.
• generateContent umożliwia generowanie prostej, bezstanowej odpowiedzi z modelu. Zalecamy korzystanie z interfejsu Interactions API, ale generateContent jest w pełni obsługiwany.

W tym przykładzie używamy interfejsu Interactions API do wysyłania żądań do interfejsu Gemini API za pomocą modelu Gemini 3 Flash.

Jeśli ustawisz klucz interfejsu API jako zmienną środowiskową GEMINI_API_KEY, klient automatycznie go wykryje podczas korzystania z bibliotek Gemini API. W przeciwnym razie podczas inicjowania klienta musisz przekazać klucz interfejsu API jako argument.

Pamiętaj, że wszystkie przykłady kodu w dokumentacji Gemini API zakładają, że masz ustawioną zmienną środowiskową GEMINI_API_KEY.

# This will only work for SDK newer than 2.0.0
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)

// This will only work for SDK newer than 2.0.0
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();

# Specifies the API revision to avoid breaking changes when they become default
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Api-Revision: 2026-05-20" \
  -d '{
    "model": "gemini-3-flash-preview",
    "input": "Explain how AI works in a few words"
  }'

Tryb bezstanowy

Domyślnie interfejs Interactions API zarządza stanem rozmowy po stronie serwera, gdy używasz previous_interaction_id. Jeśli wolisz zarządzać historią rozmów po stronie klienta, możesz włączyć tryb bezstanowy, ustawiając store=false i przekazując zgromadzone kroki w polu input w kolejnych żądaniach.

Szczegółowe informacje i pełne przykłady dotyczące wielokrotnych odpowiedzi bezstanowych znajdziesz w przewodniku po generowaniu tekstu.

Co dalej?

Po wysłaniu pierwszego żądania do interfejsu API możesz zapoznać się z tymi przewodnikami, które pokazują Gemini w działaniu:

• Generowanie tekstu
• Generowanie obrazów
• Rozpoznawanie obrazów
• Myślenie
• Wywoływanie funkcji
• Długi kontekst
• Wektory dystrybucyjne