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, rozpoznawanie 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 poziom płatny zwiększa limity ograniczania liczby żądań i wymaga skonfigurowania Rozliczeń usługi Google Cloud.

• Na stronach 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 tej kwoty) 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: