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 для его безопасного хранения.
- Откройте свой блокнот Google Colab и нажмите на вкладку 🔑 Secrets на левой панели.
Вы можете найти вкладку Secrets на левой панели.
- Создайте новый секрет с именем
GEMINI_API_KEY. - Скопируйте и вставьте свой ключ API в поле ввода
ValueдляGEMINI_API_KEY. - Переключите кнопку слева, чтобы разрешить всем блокнотам доступ к секрету.
Установка 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.