Gemini API: что это, какие модели доступны и как сделать запрос

Gemini API — это программный интерфейс к моделям семейства Gemini от Google: вы отправляете текст запросом по HTTP и получаете ответ модели в виде JSON, без чат-окна и ручного копирования. Если вы разработчик или хотите встроить Gemini в бота, таблицу или сервис, именно API вам и нужен. Ниже: как он устроен, чем нативный формат Google отличается от OpenAI-совместимого, какие модели доступны и как отправить первый запрос.

Цены указаны на 18 октября 2026. Документация Google — на ai.google.dev (раздел Gemini API); со стороны Zukko примеры ниже используют стандартный эндпоинт chat completions.

Что такое Gemini API простыми словами

Модель Gemini работает на серверах Google. API даёт вам адрес, по которому можно отправить запрос, и ключ, который подтверждает, кто вы и с чьего баланса списывать деньги. Остальное — формат сообщений.

В запросе вы указываете:

• имя модели, например gemini-3.8-flash;
• сообщения (история диалога: системная инструкция, реплики пользователя и модели);
• необязательные параметры: лимит выходных токенов, потоковый режим, инструменты.

В ответе приходит текст и данные об использовании: сколько токенов ушло на вход и выход. Цена считается по этим токенам: токен — это кусочек слова, в русском тексте на слово обычно приходится больше одного токена. Подробнее про устройство цены — в статье Что такое токены в нейросетях↗.

Не путайте Gemini API с приложением Gemini и с подпиской Google AI: приложение рассчитано на людей, а API — на код, и тарифицируется оно отдельно по токенам.

Два формата: нативный и OpenAI-совместимый

Один и тот же Gemini можно вызвать двумя способами.

Нативный формат Google. По текущему quickstart на ai.google.dev запрос идёт на https://generativelanguage.googleapis.com/v1beta/interactions, ключ передаётся в заголовке x-goog-api-key, тело содержит поля model и input. Для Python есть пакет google-genai, для JavaScript — @google/genai. Новые возможности Gemini обычно появляются в нём раньше, чем в совместимом режиме.

OpenAI-совместимый формат. У Google есть режим совместимости с библиотекой OpenAI (адрес вида .../v1beta/openai/), а шлюзы вроде Zukko отдают Gemini по стандартному эндпоинту POST /v1/chat/completions. Запрос выглядит так же, как для GPT: массив messages, поле model, заголовок Authorization: Bearer .... Преимущество — один код для разных моделей: смена Gemini на GPT или Claude означает смену строки model.

Выбирайте нативный формат, если вам нужны функции, которых ещё нет в совместимом режиме. Выбирайте OpenAI-формат, если важна переносимость, готовые интеграции (LangChain, LlamaIndex, редакторы кода) и единый баланс на разные модели.

Какие модели Gemini доступны

На странице моделей Google перечислено много вариантов: текстовые, голосовые, генерация изображений, эмбеддинги. Нас интересуют текстовые модели линейки Flash. Через Zukko на 18 октября 2026 доступны две:

Индекс силы — это Intelligence Index от Artificial Analysis. Он не говорит о том, насколько модель подходит именно вам: на классификации, извлечении данных и коротких ответах разница между моделями может быть иной, чем на длинной генерации кода. Проверяйте на своих задачах.

Официальные цены Google для gemini-3.8-flash по нашей таблице — $0.75 за 1M входных и $3.75 за 1M выходных токенов. Актуальный список и цены всегда доступны через GET https://api.zukko.pro/v1/models или страницу «Модели» в кабинете.

Две оговорки о моделях Gemini 3.x по документации Google: рассуждения (thinking) включены по умолчанию, а токены рассуждений входят в стоимость как выходные; а ещё пользовательские значения temperature и top_p у новых моделей (3.6 и новее) игнорируются.

Как сделать первый запрос

Нужен ключ. Получить его можно в кабинете Zukko на странице API-ключей↗: в окне создания задайте имя, при желании дневной и месячный лимит, и скопируйте ключ. Он показывается один раз.

curl

curl https://api.zukko.pro/v1/chat/completions \
  -H "Authorization: Bearer fetch_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.8-flash",
    "messages": [
      {"role": "user", "content": "Объясни в двух предложениях, что такое API"}
    ]
  }'

Python

from openai import OpenAI

client = OpenAI(base_url="https://api.zukko.pro/v1", api_key="fetch_ваш_ключ")

r = client.chat.completions.create(
    model="gemini-3.8-flash",
    messages=[{"role": "user", "content": "Объясни в двух предложениях, что такое API"}],
)
print(r.choices[0].message.content)
print(r.usage)

Поле usage показывает, сколько токенов потрачено. Умножьте их на цены из таблицы и вы получите стоимость запроса: например, 2000 входных и 500 выходных токенов обойдутся в 2000 × 0.125 / 1 000 000 + 500 × 0.6 / 1 000 000 = 0.00025 + 0.0003 = $0.00055.

Список моделей, доступных вашему ключу, возвращает GET /v1/models. Если указать несуществующее имя, получите 404 model_not_found.

Что умеет Gemini API

Из того, что описано в документации Google для совместимого слоя: потоковая выдача ответа, вызов функций, структурированный вывод, эмбеддинги, работа с изображениями и аудио. Важно понимать границу: Google перечисляет возможности самих моделей и своего слоя, а что именно доступно вам, зависит от модели и канала доступа. Например, в таблице Zukko у gemini-3.8-flash и gemini-3.7-flash картинки на вход не значатся, поэтому для распознавания изображений берите модель с этой возможностью (скажем, claude-sonnet-5-5, gpt-6.1-sol или qwen3.8-max) и проверяйте на своих данных.

Типичные задачи для недорогих Flash-моделей: классификация обращений, извлечение полей из текста, сводки, перевод, ответы в чат-ботах. Для сложных агентных задач часто берут модели сильнее; решать стоит по цене и индексу силы, а не по названию. Сравнение двух недорогих вариантов — в статье DeepSeek или Gemini Flash↗.

Где читать документацию

• Gemini API на ai.google.dev: разделы Quickstart, Models, Pricing, Rate limits, OpenAI compatibility.
• Zukko: быстрый старт↗, список моделей↗.

Для начала достаточно создать ключ в кабинете и повторить пример на curl: это занимает пару минут.

Частые вопросы

Gemini API — это то же самое, что Gemini в браузере?

Нет. Приложение предназначено для людей, API — для кода. Тарифицируются они независимо, а запросы в API идут по токенам.

Нужно ли учить отдельный формат Gemini?

Нет. Gemini можно вызывать в привычном OpenAI-формате через POST /v1/chat/completions. Нативный формат Google нужен, только если вам требуются возможности, которых нет в совместимом режиме.

Какие модели Gemini есть в Zukko?

На 18 октября 2026 — gemini-3.8-flash и gemini-3.7-flash. Список может меняться: сверяйтесь с GET /v1/models.

Как узнать, сколько стоит запрос?

В ответе есть блок usage с числом токенов. Умножьте вход и выход на цены за 1M токенов и сложите. Фактическую сумму списания видно в кабинете («Использование»).