Использование ключей API Gemini

Для использования API Gemini вам потребуется ключ API. На этой странице описано, как создавать и управлять ключами в Google AI Studio, а также как настроить среду для их использования в вашем коде.

Создать или просмотреть ключ API Gemini

Ключи API

Вы можете создавать и управлять всеми своими ключами API Gemini на странице ключей API Google AI Studio .

Получив ключ API, вы можете подключиться к API Gemini следующими способами:

• Установка вашего API-ключа в качестве переменной окружения
• Укажите свой API-ключ явно.

Для первоначального тестирования можно указать ключ API напрямую, но это должно быть лишь временным решением, поскольку такое указание небезопасно. Примеры указания ключа API напрямую можно найти в разделе «Указание ключа API явным образом» .

Проекты Google Cloud

Проекты Google Cloud имеют основополагающее значение для использования сервисов Google Cloud (таких как API Gemini), управления выставлением счетов, а также контроля над соавторами и правами доступа. Google AI Studio предоставляет облегченный интерфейс для работы с вашими проектами Google Cloud.

Если у вас еще нет созданных проектов, вам необходимо либо создать новый проект, либо импортировать существующий из Google Cloud в Google AI Studio. На странице «Проекты» в Google AI Studio отобразятся все ключи, имеющие достаточные права доступа для использования API Gemini. Инструкции по импорту проектов см. в соответствующем разделе.

Проект по умолчанию

Для новых пользователей после принятия Условий использования Google AI Studio создаст проект Google Cloud и ключ API по умолчанию для удобства использования. Вы можете переименовать этот проект в Google AI Studio, перейдя в раздел «Проекты» на панели управления , нажав кнопку с тремя точками рядом с проектом и выбрав «Переименовать проект» . Для существующих пользователей или пользователей, у которых уже есть учетные записи Google Cloud, проект по умолчанию не будет создан.

импортные проекты

Каждый ключ API Gemini связан с проектом Google Cloud. По умолчанию Google AI Studio не отображает все ваши проекты Cloud. Вам необходимо импортировать нужные проекты, выполнив поиск по имени или идентификатору проекта в диалоговом окне «Импорт проектов» . Чтобы просмотреть полный список проектов, к которым у вас есть доступ, посетите консоль Cloud.

Если у вас еще нет импортированных проектов, выполните следующие действия, чтобы импортировать проект Google Cloud и создать ключ:

1. Перейдите в Google AI Studio .
2. Откройте панель управления с левой боковой панели.
3. Выберите проекты .
4. На странице «Проекты» нажмите кнопку «Импорт проектов» .
5. Найдите и выберите проект Google Cloud, который хотите импортировать, и нажмите кнопку «Импорт» .

После импорта проекта перейдите на страницу «Ключи API» в меню «Панель управления» и создайте ключ API для только что импортированного проекта.

Ограничения

Ниже перечислены ограничения на управление ключами API и проектами Google Cloud в Google AI Studio.

• На странице «Проекты» в Google AI Studio можно создать максимум 10 проектов одновременно.
• Вы можете давать имена и переименовывать проекты и ключи.
• На страницах «Ключи API» и «Проекты» отображается максимум 100 ключей и 50 проектов.
• Отображаются только ключи API, не имеющие ограничений или предназначенные только для API генеративного языка.

Для получения дополнительных прав управления проектами посетите консоль Google Cloud.

Установка ключа API в качестве переменной среды

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

Если вы используете REST API или JavaScript в браузере, вам потребуется явно указать ключ API.

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

~/.bashrc

touch ~/.bashrc
open ~/.bashrc

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

source ~/.bashrc

~/.zshrc

touch ~/.zshrc
open ~/.zshrc

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

source ~/.zshrc

Указание ключа API явным образом

В некоторых случаях может потребоваться явно указать ключ API. Например:

• Вы выполняете простой вызов API и предпочитаете жестко задать ключ API.
• Вам нужен явный контроль без необходимости полагаться на автоматическое обнаружение переменных окружения библиотеками API Gemini.
• Вы используете среду, в которой не поддерживаются переменные окружения (например, веб-интерфейс), или выполняете REST-запросы.

Ниже приведены примеры того, как можно явно указать ключ API:

from google import genai

client = genai.Client(api_key="YOUR_API_KEY")

response = client.models.generate_content(
    model="gemini-2.5-flash", contents="Explain how AI works in a few words"
)
print(response.text)

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

const ai = new GoogleGenAI({ apiKey: "YOUR_API_KEY" });

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-2.5-flash",
    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()
    client, err := genai.NewClient(ctx, &genai.ClientConfig{
        APIKey:  "YOUR_API_KEY",
        Backend: genai.BackendGeminiAPI,
    })
    if err != nil {
        log.Fatal(err)
    }

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

package com.example;

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

public class GenerateTextFromTextInput {
  public static void main(String[] args) {
    Client client = Client.builder().apiKey("YOUR_API_KEY").build();

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

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

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

Обеспечьте безопасность своего API-ключа.

Относитесь к своему API-ключу Gemini как к паролю. В случае компрометации другие лица смогут использовать квоту вашего проекта, понести расходы (если включена оплата) и получить доступ к вашим личным данным, таким как файлы.

Важные правила безопасности

• Сохраняйте ключи в тайне : API-ключи для Gemini могут предоставлять доступ к конфиденциальным данным, от которых зависит ваше приложение.

  • Никогда не добавляйте ключи API в систему контроля версий. Не загружайте свой ключ API в системы контроля версий, такие как Git.

  • Никогда не раскрывайте ключи API на стороне клиента. Не используйте свой ключ API напрямую в веб- или мобильных приложениях в рабочей среде. Ключи в клиентском коде (включая наши библиотеки JavaScript/TypeScript и REST-запросы) могут быть извлечены.

• Ограничение доступа : По возможности ограничьте использование ключей API определенными IP-адресами, HTTP-реферерами или приложениями для Android/iOS.

• Ограничение использования : Включайте только необходимые API для каждого ключа.

• Проводите регулярные проверки : Регулярно проверяйте свои API-ключи и периодически меняйте их.

Передовые методы

• Используйте серверные вызовы с помощью ключей API. Самый безопасный способ использования вашего ключа API — это вызов API Gemini из серверного приложения, где ключ может храниться в конфиденциальности.

• Используйте временные токены для доступа на стороне клиента (только для Live API): Для прямого доступа к Live API на стороне клиента можно использовать временные токены. Они сопряжены с меньшими рисками безопасности и подходят для использования в производственной среде. Для получения дополнительной информации ознакомьтесь с руководством по временным токенам .

• Рассмотрите возможность добавления ограничений к вашему ключу: вы можете ограничить права доступа ключа, добавив ограничения для ключа API . Это минимизирует потенциальный ущерб в случае утечки ключа.

Для ознакомления с общими рекомендациями вы также можете обратиться к этой статье службы поддержки .