Краткое руководство по API Gemini

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

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

Для использования 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

Идти

Установите google.golang.org/genai в каталог вашего модуля, используя команду `go get` :

go get google.golang.org/genai

Java

Если вы используете Maven, вы можете установить google-genai , добавив следующее в ваши зависимости:

<dependencies>
  <dependency>
    <groupId>com.google.genai</groupId>
    <artifactId>google-genai</artifactId>
    <version>1.0.0</version>
  </dependency>
</dependencies>

C#

Установите googleapis/go-genai в каталог вашего модуля, используя команду dotnet add.

dotnet add package Google.GenAI

Apps Script

  1. Чтобы создать новый проект Apps Script, перейдите по адресу script.new .
  2. Нажмите на проект без названия .
  3. Переименуйте проект Apps Script в AI Studio и нажмите «Переименовать» .
  4. Укажите свой API-ключ
    1. Слева нажмите «Настройки проекта» . Значок для настроек проекта .
    2. В разделе «Свойства скрипта» нажмите «Добавить свойство скрипта» .
    3. В поле «Свойства» введите имя ключа: GEMINI_API_KEY .
    4. В поле «Значение» введите значение ключа API.
    5. Нажмите «Сохранить свойства скрипта» .
  5. Замените содержимое файла Code.gs следующим кодом:

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

Вот пример, в котором метод generateContent используется для отправки запроса к API Gemini с помощью модели Gemini 2.5 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()

response = client.models.generate_content(
    model="gemini-3-flash-preview", contents="Explain how AI works in a few words"
)
print(response.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 response = await ai.models.generateContent({
    model: "gemini-3-flash-preview",
    contents: "Explain how AI works in a few words",
  });
  console.log(response.text);
}

main();

Идти 

package main

import (
    "context"
    "fmt"
    "log"
    "google.golang.org/genai"
)

func main() {
    ctx := context.Background()
    // The client gets the API key from the environment variable `GEMINI_API_KEY`.
    client, err := genai.NewClient(ctx, nil)
    if err != nil {
        log.Fatal(err)
    }

    result, err := client.Models.GenerateContent(
        ctx,
        "gemini-3-flash-preview",
        genai.Text("Explain how AI works in a few words"),
        nil,
    )
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(result.Text())
}

Java 

package com.example;

import com.google.genai.Client;
import com.google.genai.types.GenerateContentResponse;

public class GenerateTextFromTextInput {
  public static void main(String[] args) {
    // The client gets the API key from the environment variable `GEMINI_API_KEY`.
    Client client = new Client();

    GenerateContentResponse response =
        client.models.generateContent(
            "gemini-3-flash-preview",
            "Explain how AI works in a few words",
            null);

    System.out.println(response.text());
  }
}

C# 

using System.Threading.Tasks;
using Google.GenAI;
using Google.GenAI.Types;

public class GenerateContentSimpleText {
  public static async Task main() {
    // The client gets the API key from the environment variable `GEMINI_API_KEY`.
    var client = new Client();
    var response = await client.Models.GenerateContentAsync(
      model: "gemini-3-flash-preview", contents: "Explain how AI works in a few words"
    );
    Console.WriteLine(response.Candidates[0].Content.Parts[0].Text);
  }
}

Apps Script 

// See https://developers.google.com/apps-script/guides/properties
// for instructions on how to set the API key.
const apiKey = PropertiesService.getScriptProperties().getProperty('GEMINI_API_KEY');
function main() {
  const payload = {
    contents: [
      {
        parts: [
          { text: 'Explain how AI works in a few words' },
        ],
      },
    ],
  };

  const url = 'https://generativelanguage.googleapis.com/v1beta/models/gemini-3-flash-preview:generateContent';
  const options = {
    method: 'POST',
    contentType: 'application/json',
    headers: {
      'x-goog-api-key': apiKey,
    },
    payload: JSON.stringify(payload)
  };

  const response = UrlFetchApp.fetch(url, options);
  const data = JSON.parse(response);
  const content = data['candidates'][0]['content']['parts'][0]['text'];
  console.log(content);
}

ОТДЫХ 

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3-flash-preview:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

Что дальше?

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