Первый вызов Gemini API

Получаем API-ключ в AI Studio, ставим google-generativeai, делаем первый generate_content и разбираем структуру ответа.

20 мин чтения4 вопроса в квизеГотовый промпт включёнВ работе

Практическое задание

Что сделать после урока

Сделайте первый вызов на Python к gemini-2.0-flash. Выведите response.text, finish_reason кандидата и usage_metadata.total_token_count. Затем намеренно вызовите .text после жёсткого safety-блока (например, опасный запрос) и обработайте исключение через try/except.

Готовый промпт

Шаблон под задачу урока

Скопируйте и адаптируйте под свой контекст. Текст в треугольных скобках — то, что нужно заменить.

Я подключаю Google Gemini API.
Язык: <Python / JavaScript>
Задача: <…>

Дай минимальный рабочий пример: configure с ключом из окружения,
GenerativeModel("gemini-2.0-flash"), generate_content, безопасное чтение
текста из candidates[].content.parts с проверкой finish_reason. Без лишних абстракций.

Установка SDK

pip install google-generativeai # Python npm install @google/generative-ai # JavaScript

Ключ получаете бесплатно в Google AI Studio и кладёте в переменную окружения GEMINI_API_KEY. Никогда не хардкодьте ключ в репозитории и не зовите Gemini напрямую из браузера — ключ утечёт.

import os import google.generativeai as genai genai.configure(api_key=os.environ["GEMINI_API_KEY"]) model = genai.GenerativeModel("gemini-2.0-flash") response = model.generate_content("Объясни замыкания в JS за 3 предложения") print(response.text)

То же на JavaScript

import { GoogleGenerativeAI } from "@google/generative-ai"; const genAI = new GoogleGenerativeAI(process.env.GEMINI_API_KEY); const model = genAI.getGenerativeModel({ model: "gemini-2.0-flash" }); const result = await model.generateContent("Объясни замыкания за 3 предложения"); console.log(result.response.text());

Что внутри ответа

Объект GenerateContentResponse содержит:

candidates — список вариантов ответа (обычно один). Внутри content.parts — массив частей.

response.text — удобный хелпер, который склеивает текстовые parts первого кандидата. Если кандидат был отфильтрован, обращение к .text бросит исключение.

candidates[0].finish_reason — STOP, MAX_TOKENS, SAFETY, RECITATION.

prompt_feedback — почему промпт мог быть заблокирован (block_reason).

usage_metadata — prompt_token_count, candidates_token_count, total_token_count для подсчёта стоимости.

Безопасное чтение

cand = response.candidates[0] if cand.finish_reason.name == "SAFETY": print("Ответ заблокирован фильтром безопасности") else: text = "".join(p.text for p in cand.content.parts if p.text) print(text, response.usage_metadata.total_token_count)

Не читайте response.text вслепую: при finish_reason == SAFETY или пустом кандидате это исключение, а не пустая строка. В продакшне всегда проверяйте finish_reason и prompt_feedback.

Сообщить об ошибке

Первый вызов Gemini API

Квиз — 4 вопроса

Установка SDK

Минимальный вызов на Python

То же на JavaScript

Что внутри ответа

Безопасное чтение