Быстрый старт с Gemini API

В этом кратком руководстве показано, как установить наши библиотеки и выполнить первый запрос к Gemini API с помощью Interactions API.

Прежде чем начать

Для использования API Gemini требуется ключ API, который вы можете создать бесплатно, чтобы начать работу.

Создайте ключ API Gemini

Установите Google GenAI SDK.

Python

При использовании Python 3.9+ установите пакет google-genai с помощью следующей команды pip :

pip install -q -U google-genai

JavaScript

При использовании Node.js версии 18+ установите Google Gen AI SDK для TypeScript и JavaScript, используя следующую команду npm :

npm install @google/genai

Сделайте свой первый запрос

Вот пример использования API Interactions для отправки запроса к API Gemini с помощью модели Gemini 3 Flash.

Если вы зададите свой API-ключ в качестве переменной окружения GEMINI_API_KEY , он будет автоматически распознан клиентом при использовании библиотек API Gemini . В противном случае вам потребуется передать свой API-ключ в качестве аргумента при инициализации клиента.

Обратите внимание, что все примеры кода в документации по API Gemini предполагают, что у вас установлена ​​переменная среды GEMINI_API_KEY .

Python 

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)

JavaScript 

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();

ОТДЫХ 

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

Что дальше?

После того, как вы отправили свой первый API-запрос, вам может быть полезно ознакомиться со следующими руководствами, демонстрирующими работу Gemini:

,

Быстрый старт с Gemini API

В этом кратком руководстве показано, как установить наши библиотеки и выполнить первый запрос к Gemini API с помощью Interactions API.

Прежде чем начать

Для использования API Gemini требуется ключ API, который вы можете создать бесплатно, чтобы начать работу.

Создайте ключ API Gemini

Установите Google GenAI SDK.

Python

При использовании Python 3.9+ установите пакет google-genai с помощью следующей команды pip :

pip install -q -U google-genai

JavaScript

При использовании Node.js версии 18+ установите Google Gen AI SDK для TypeScript и JavaScript, используя следующую команду npm :

npm install @google/genai

Сделайте свой первый запрос

Вот пример использования API Interactions для отправки запроса к API Gemini с помощью модели Gemini 3 Flash.

Если вы зададите свой API-ключ в качестве переменной окружения GEMINI_API_KEY , он будет автоматически распознан клиентом при использовании библиотек API Gemini . В противном случае вам потребуется передать свой API-ключ в качестве аргумента при инициализации клиента.

Обратите внимание, что все примеры кода в документации по API Gemini предполагают, что у вас установлена ​​переменная среды GEMINI_API_KEY .

Python 

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)

JavaScript 

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();

ОТДЫХ 

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

Что дальше?

После того, как вы отправили свой первый API-запрос, вам может быть полезно ознакомиться со следующими руководствами, демонстрирующими работу Gemini: