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 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 5 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.

Python

Zainstaluj pakiet SDK:

pip install -U google-genai

Zainicjuj klienta i wyślij żądanie:

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

Zainstaluj pakiet SDK:

npm install @google/genai

Zainicjuj klienta i wyślij żądanie:

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 words"))
        .build();

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

System.out.println(interaction