> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini API: линейка моделей, длинный контекст и мультимодальность

> Вся линейка Gemini — Pro, Flash, Flash-Lite и модели генерации изображений. Очень большое окно контекста, приём картинок и их генерация, как выбрать версию и как подключить.

Gemini от Google — самая мультимодальная линейка на RuAPI: модели читают текст **и картинки**, а часть из них ещё и **рисует изображения**. Плюс очень большое окно контекста и несколько уровней — от лёгкого Flash-Lite до тяжёлого Pro. Ниже разбираем всю линейку и то, как выбрать версию под задачу. Все модели говорят по OpenAI-совместимому протоколу — подключение в [Быстром старте](/ru/quickstart).

## Вся линейка Gemini

| Уровень        | Под что берут                                       | Скорость / цена            |
| -------------- | --------------------------------------------------- | -------------------------- |
| **Pro**        | Сложный код, рассуждения, разбор больших документов | Медленнее, дороже          |
| **Flash**      | Универсал: чат-боты, ассистенты, средний поток      | Быстро, средняя цена       |
| **Flash-Lite** | Массовая обработка, классификация, теги на потоке   | Самая быстрая и дешёвая    |
| **Image**      | Генерация и редактирование картинок                 | Отдельные модели генерации |

<Tip>
  Начните с **Flash** как с золотой середины. Упираетесь в скорость и цену на большом потоке — спускайтесь на **Flash-Lite**; не хватает глубины на сложной задаче — поднимайтесь на **Pro**.
</Tip>

## Очень большое окно контекста

Исторически сильная сторона Gemini — **огромный контекст**: в окно помещаются целые отчёты, длинные логи и большие кодовые базы без нарезки на куски. Это удобно для разбора документов, RAG с крупными фрагментами и анализа длинных диалогов. Точный лимит зависит от версии и совпадает с официальным лимитом Google — актуальные значения смотрите на странице **«Цены»** на [www.ruapi.ai](https://www.ruapi.ai).

## Мультимодальность: видит картинки и рисует их

<Info>
  Gemini работает с изображениями в две стороны. **На вход** (vision) модели принимают картинки вместе с текстом — как отправить изображение в запросе, показано в гайде по [работе с изображениями](/ru/vision). **На выход** отдельные модели генерируют и редактируют изображения: `gemini-2.5-flash-image`, `gemini-3.1-flash-image-preview`, `gemini-3-pro-image-preview`. Точные текущие имена этих preview-моделей — на странице «Цены».
</Info>

Текстовые модели линейки — `gemini-3.5-flash`, `gemini-3.1-pro-preview`, `gemini-2.5-pro`, `gemini-2.5-flash`, `gemini-2.5-flash-lite`. Они умеют [вызывать функции](/ru/function-calling) и [выводить ответ потоком](/ru/streaming) по токенам.

## Какую версию брать (2.5 / 3 / 3.1 / 3.5 / 3.6)

* **2.5** (`gemini-2.5-pro`, `gemini-2.5-flash`, `gemini-2.5-flash-lite`) — зрелое и стабильное поколение, хороший выбор по умолчанию.
* **3 / 3.1** — более новые модели, включая preview-версии (`gemini-3-flash-preview`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`) и генерацию изображений; берите ради свежих возможностей, помня, что preview-имена могут меняться.
* **3.5** (`gemini-3.5-flash`, `gemini-3.5-flash-lite`) — свежее поколение Flash: `-flash-lite` заметно дешевле и быстрее, `-flash` сильнее.
* **3.6** (`gemini-3.6-flash`) — самое новое поколение Flash, актуальный выбор для нового кода.

<Note>
  Preview-модели меняют имена по мере выхода новых версий. Не хардкодьте ID — точные текущие имена и цены за токен всегда на странице **«Цены»** на [www.ruapi.ai](https://www.ruapi.ai).
</Note>

## Подключение Gemini

Отдельная библиотека Google не нужна: эндпоинт **OpenAI-совместимый**, берёте любой OpenAI SDK и меняете `base_url`.

* **base\_url:** `https://www.ruapi.ai/v1`
* **model:** например `gemini-3.6-flash`

Тот же ключ работает в Cursor, Cline, n8n и LangChain. Пошаговый код на Python и curl — в [Быстром старте](/ru/quickstart). Пополнить баланс можно в [разделе оплаты](/ru/topup).

## Дальше

<CardGroup cols={2}>
  <Card title="Подключение и первый запрос" icon="bolt" href="/ru/quickstart">
    base\_url, ключ, код на Python и curl.
  </Card>

  <Card title="Модели Claude" icon="brain" href="/ru/claude-api">
    Тот же ключ — выбор и возможности Claude.
  </Card>

  <Card title="Модели GPT" icon="robot" href="/ru/gpt-api">
    Линейка OpenAI на том же эндпоинте.
  </Card>
</CardGroup>