Pierwsze kroki

Z tego przewodnika dowiesz się, jak zacząć korzystać z interfejsu Gemini API za pomocą Interactions API. Pierwsze wywołanie interfejsu API wykonasz w mniej niż minutę. Poznasz generowanie tekstu, rozumienie multimodalne, generowanie obrazów, dane wyjściowe strukturalne, narzędzia, wywoływanie funkcji, agentów i wykonywanie w tle.

Interfejs Interactions API jest dostępny w pakietach SDK w językach Python i JavaScript, a także w ramach REST.

1. Uzyskiwanie klucza interfejsu API

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

• Google AI Studio automatycznie tworzy projekt i klucz interfejsu API dla nowych użytkowników. Możesz go skopiować ze strony kluczy interfejsów API.
• Jeśli potrzebujesz nowego klucza, w AI Studio kliknij Utwórz klucz interfejsu API i postępuj zgodnie z instrukcjami w oknie, aby dodać nową parę klucz-projekt.

Tworzenie klucza interfejsu Gemini API

Ustaw klucz jako zmienną środowiskową:

export GEMINI_API_KEY="YOUR_API_KEY"

Przejście na poziom płatny

Przejście na płatny poziom zwiększa limity ograniczania liczby żądań i wymaga skonfigurowania Rozliczeń usługi Google Cloud.

• Na stronie AI Studio Klucze interfejsu API lub Projekty kliknij Skonfiguruj rozliczenia.
• Postępuj zgodnie z instrukcjami w oknie dialogowym Rozliczenia usługi Google Cloud, aby utworzyć lub połączyć konto rozliczeniowe, dodać formę płatności i dokonać przedpłaty w wysokości co najmniej 10 USD (lub równowartości w innej walucie) w postaci środków.
• Wykorzystanie interfejsu API możesz sprawdzić w Google AI Studio w sekcji Panel > Wykorzystanie.

Więcej informacji znajdziesz na stronie Płatności.

2. Instalowanie pakietu SDK i wykonywanie pierwszego wywołania

Zainstaluj pakiet SDK i wygeneruj tekst za pomocą jednego wywołania interfejsu API.

pip install -U google-genai

from google import genai

client = genai.Client()

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

npm install @google/genai

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

const ai = new GoogleGenAI({});

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

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

Odpowiedź:

{
  "id": "v1_ChdpQUFvYXI...",
  "status": "completed",
  "usage": {
    "total_tokens": 197,
    "total_input_tokens": 8,
    "total_output_tokens": 12
  },
  "created": "2026-06-09T12:01:25Z",
  "steps": [
    {