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

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

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

• Установка ключа API в качестве переменной среды
• Явное предоставление вашего ключа API

Для первоначального тестирования вы можете жестко закодировать ключ API, но это должно быть только временно, поскольку это небезопасно. Вы можете найти примеры жесткого кодирования ключа 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-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?key=$YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

Сохраните свой ключ API в безопасности

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

Критические правила безопасности

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

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

Лучшие практики

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

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

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

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