Использование ключей 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 projects are fundamental to using Google Cloud services (such as the Gemini API), managing billing, and controlling collaborators and permissions. Google AI Studio provides a lightweight interface to your Google Cloud projects.

Если у вас еще нет созданных проектов, вам необходимо либо создать новый проект, либо импортировать существующий из 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, который хотите импортировать, и нажмите кнопку «Импорт» .

Once a project is imported, go to the API Keys page from the Dashboard menu and create an API key in the project you just imported.

Ограничения

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

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

Для получения дополнительных прав управления проектами, включая изменение и ограничение доступа к ключам API, посетите страницу учетных данных в консоли Google Cloud . В консоли Cloud вы можете выбрать свой проект, щелкнуть существующий ключ API, а затем ограничить его доступ только к API генеративного языка .

Установка ключа 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-3.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-3.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-3.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-3.5-flash",
            "Explain how AI works in a few words",
            null);

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

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.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 . Это минимизирует потенциальный ущерб в случае утечки ключа.

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

Надежные неограниченные ключи API

Ключи API без ограничений уязвимы для злоумышленников и несанкционированного использования. Начиная с 19 июня 2026 года, в целях повышения безопасности, поддержка ключей трафика без ограничений в API Gemini будет прекращена.

Это означает, что ваши запросы к API Gemini завершатся неудачей, если вы не предпримете никаких действий.

Чтобы продолжить бесперебойное использование API Gemini, защитите ключи трафика, добавив ограничения в AI Studio .

На сайте aistudio.google.com/api-keys вы увидите баннер, уведомляющий о снятии ограничений на использование API-ключей. Вы можете увидеть, какие ключи не имеют ограничений, а также данные об использовании сервиса за последние 90 дней.

Для неограниченных ключей необходимо выбрать один из следующих вариантов:

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

Ограничьте использование ключа только API Gemini.

Если вы хотите ограничить доступ к ключу только для API Gemini, защитите свой ключ в AI Studio , нажав кнопку « Ограничить доступ только для API Gemini» .

Ограничить использование ключа только для пользователей, не использующих API Gemini.

Если вы хотите ограничить использование ключа только для API, не относящихся к Gemini:

1. Перейдите на страницу ввода учетных данных в консоли Google Cloud .
2. Убедитесь, что проект выбран правильно.
3. Выберите ключ API.
4. Разверните выпадающее меню « Ограничения API» и примените ограничения сервиса к ключу API.

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

Заблокированные ключи

Начиная с 7 мая 2026 года, API Gemini будет блокировать неограниченные ключи API, которые долгое время оставались неактивными. Пользователи, использующие API Gemini, увидят метку «Заблокировано» для своего ключа на aistudio.google.com/api-keys и им потребуется сгенерировать новый ключ или использовать альтернативный ограниченный ключ, чтобы продолжить использование API Gemini.

Устранение неполадок при создании ключа API

В Google AI Studio кнопка «Создать ключ API» может отображаться как недоступная с сообщением: « У вас нет разрешения на создание ключа в этом проекте ».

Это происходит, когда у вас отсутствуют необходимые права доступа в проекте для генерации нового ключа:

• resourcemanager.projects.get : Позволяет AI Studio проверить существование проекта.
• apikeys.keys.create : Позволяет сгенерировать сам ключ API.
• serviceusage.services.enable : Необходимо для обеспечения активности API Gemini в проекте.
• iam.serviceAccounts.create : Теперь для каждого нового ключа API требуется связанная учетная запись службы , генерируемая при создании ключа API.
• iam.serviceAccountApiKeyBindings.create : Требуется для привязки вновь созданной учетной записи службы к ключу API.

Чтобы исправить права доступа, попросите администратора проекта или администратора организации, если проект принадлежит организации , предоставить вам роль с указанными выше правами доступа (например, редактор проекта или пользовательскую роль).

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

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