Руководство по началу работы с Gemini 2.5 Pro: поиск, создание и анализ

Ваш первый час с Gemini 2.5 Pro

Если у вас есть 60 минут и вы хотите пройти путь от нуля до работающей интеграции с Gemini 2.5 Pro, это руководство для вас. За последние два месяца я провёл через этот процесс около 300 разработчиков. Лучший паттерн: сначала заставить что-то работать, потом понять почему.

Шаг 1: Получение API-ключа (5 минут)

Перейдите в Google AI Studio (aistudio.google.com). Бесплатный уровень даёт 60 запросов в минуту для Gemini 2.5 Pro. Храните ключ API в переменной окружения, а не в коде. Добавьте .env в .gitignore.

Шаг 2: Первый вызов API (10 минут)

npm install @google/genai

import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
const response = await ai.models.generateContent({
  model: "gemini-2.5-pro",
  contents: "Объясните разницу между REST и GraphQL в двух абзацах.",
});
console.log(response.text);

Стоимость токенов: ввод $1.25/млн, вывод $5/млн. Типичный запрос стоит около $0.001.

Шаг 3: Создание анализатора документов (25 минут)

Постройте полезный инструмент: принять PDF, извлечь содержимое, сгенерировать структурированное резюме. Используйте responseMimeType: "application/json" для принудительного структурированного вывода — функция, специфичная для Gemini, гарантирующая валидный JSON.

Шаг 4: Добавление search grounding (10 минут)

Google Search Grounding дополняет ответы результатами поиска в реальном времени. Добавляет 1-3 секунды задержки и доступен не во всех регионах.

Шаг 5: Обработка ошибок и лимиты (10 минут)

Экспоненциальный backoff для 429, линейный для 500/503. SDK не имеет встроенной логики повторных попыток.

Что строить дальше

Три идеи: конспектёр встреч, конвертер скриншотов в код, анализатор качества контента. API Gemini 2.5 Pro стабильно работает в продакшене с марта 2026 года. Не думайте слишком много — просто начните строить.