Бесплатный урок Официальный курс Gemini API Cookbook на русском
Урок 03 · Текст · ~5 мин

Как подключиться к API

Урок 3 из 71 курса «Gemini API: быстрый старт»: официальный курс Gemini API Cookbook (Гугл Джемини) на русском языке. Этот урок бесплатный.

Copyright 2026 Google LLC.
# @title Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

Gemini API: Быстрый старт по аутентификации

Изображение (внешний источник)

Gemini API использует ключи API для аутентификации. Этот блокнот проведет вас через процесс создания ключа API и его использования с Python SDK или инструментом командной строки, таким как curl.

Примечание: Этот блокнот использует Interactions API, новейший способ взаимодействия с моделями Gemini. Ищете версию generateContent? Проверьте архивную ветку.

Создание ключа API

Вы можете создать свой ключ API с помощью Google AI Studio одним щелчком мыши.

Помните, что к ключу API следует относиться как к паролю. Не сохраняйте его случайно в блокноте или исходном файле, который вы позже зафиксируете в GitHub. Этот блокнот покажет вам два способа безопасного хранения ключа API.

  • Если вы используете Google Colab, рекомендуется хранить ключ в Colab Secrets.

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

Начнем с Colab Secrets.

Добавьте свой ключ в Colab Secrets

Добавьте свой ключ API в менеджер Colab Secrets для его безопасного хранения.

  1. Откройте свой блокнот Google Colab и нажмите на вкладку 🔑 Secrets на левой панели.

Вы можете найти вкладку Secrets на левой панели.

  1. Создайте новый секрет с именем GEMINI_API_KEY.
  2. Скопируйте и вставьте свой ключ API в поле ввода Value для GEMINI_API_KEY.
  3. Переключите кнопку слева, чтобы разрешить всем блокнотам доступ к секрету.

Установка Python SDK

%pip install -qU "google-genai>=2.9.0" # 2.0 is needed to use the interactions API
[?25l   [90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━[0m [32m0.0/200.0 kB[0m [31m?[0m eta [36m-:--:--[0m
[2K   [91m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━[0m[91m╸[0m[90m━[0m [32m194.6/200.0 kB[0m [31m29.4 MB/s[0m eta [36m0:00:01[0m
[2K   [90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━[0m [32m200.0/200.0 kB[0m [31m5.7 MB/s[0m eta [36m0:00:00[0m
[?25h

Настройка SDK с вашим ключом API

Вы создаете клиент, используя свой ключ API, но вместо того, чтобы вставлять ключ в блокнот, вы будете читать его из Colab Secrets благодаря userdata.

from google import genai
from google.colab import userdata

GEMINI_API_KEY = userdata.get('GEMINI_API_KEY')
client = genai.Client(api_key=GEMINI_API_KEY)

Теперь выберите модель. Gemini API предлагает различные модели, оптимизированные для конкретных случаев использования. Для получения дополнительной информации проверьте модели Gemini

MODEL_ID = "gemini-3.8-flash" # @param ["gemini-4-argon", "gemini-3.1-pro-preview", "gemini-3.8-flash", "gemini-3.7-flash", "gemini-3.6-flash", "gemini-3.5-flash-lite", "gemini-2.5-pro"] {"allow-input": true, "isTemplate": true}

И это все! Теперь вы готовы вызывать Gemini API.

from IPython.display import display, Markdown

interaction = client.interactions.create(
    model=MODEL_ID,
    input="Please give me python code to sort a list."
)

display(Markdown(interaction.steps[-1].content[0].text))
<IPython.core.display.Markdown object>

Хранение ключа в переменной среды

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

Чтобы сохранить ключ в переменной среды, откройте терминал и выполните:

export GEMINI_API_KEY="YOUR_API_KEY"

Если вы используете Python, вы можете добавить эти две строки в свой блокнот, чтобы прочитать ключ:

client = genai.Client(api_key=os.environ['GEMINI_API_KEY'])

В качестве альтернативы, если ключ не предоставлен явно, клиент будет искать его.

client = genai.Client()

Или, если вы вызываете API через терминал с помощью cURL, вы можете скопировать и вставить этот код, чтобы прочитать ключ из переменной среды.

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.7-flash:generateContent?key=$GEMINI_API_KEY" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [{
        "parts":[{
          "text": "Please give me Python code to sort a list."
        }]
      }]
    }'

Узнать больше

Теперь, когда вы знаете, как управлять своим ключом API, у вас есть все, чтобы начать работу с Gemini. Проверьте все руководства по быстрому старту из Cookbook, и в частности руководство по началу работы.

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

Для аутентификации Vertex AI обратитесь к документации по аутентификации Vertex AI.

Следующий урок · 04Вход через OAuth

Полезные гиды