Перейти к основному содержимому

Google Gemini

VibeOS поддерживает Google Gemini как нативного провайдера через Google AI Studio / Gemini API (не OpenAI-совместимый эндпоинт). Это позволяет VibeOS преобразовывать внутренний цикл сообщений и инструментов, ориентированный на OpenAI, в нативный API Gemini generateContent, сохраняя при этом вызов инструментов, стриминг, мультимодальные входные данные и метаданные ответов, специфичные для Gemini.

Предварительные требования​

  • API-ключ Google AI Studio — создайте на aistudio.google.com/apikey
  • Проект Google Cloud с включённым биллингом — рекомендуется для использования агентами. Бесплатный тариф Gemini слишком мал для длительных сессий агентов, так как VibeOS может выполнять несколько вызовов модели за один пользовательский шаг.
  • Установленный VibeOS — для нативного провайдера Gemini не требуется дополнительных пакетов Python.
Путь к API-ключу

Установите GOOGLE_API_KEY или GEMINI_API_KEY. VibeOS проверяет оба имени для провайдера gemini.

Быстрый старт​

# Добавьте ваш API-ключ Gemini
echo "GOOGLE_API_KEY=..." >> ~/.vibeos/.env

# Выберите Gemini в качестве провайдера
vibeos model
# → Выберите «More providers...» → «Google AI Studio»
# → VibeOS проверит ваш тариф и покажет модели Gemini
# → Выберите модель

# Начните чат
vibeos chat

Если вы предпочитаете редактировать конфигурацию напрямую, используйте нативный базовый URL Gemini API:

model:
  default: gemini-3-flash-preview
  provider: gemini
  base_url: https://generativelanguage.googleapis.com/v1beta

Конфигурация​

После выполнения vibeos model ваш ~/.vibeos/config.yaml будет содержать:

model:
  default: gemini-3-flash-preview
  provider: gemini
  base_url: https://generativelanguage.googleapis.com/v1beta

А в ~/.vibeos/.env:

GOOGLE_API_KEY=...

Нативный Gemini API​

Рекомендуемый эндпоинт:

https://generativelanguage.googleapis.com/v1beta

VibeOS обнаруживает этот эндпоинт и создаёт свой нативный адаптер Gemini. Внутренне VibeOS по-прежнему хранит цикл агента в сообщениях, ориентированных на OpenAI, а затем преобразует каждый запрос в нативную схему Gemini:

  • messages[] → Gemini contents[]
  • системные промпты → Gemini systemInstruction
  • схемы инструментов → Gemini functionDeclarations
  • результаты инструментов → части Gemini functionResponse
  • стриминговые ответы → чанки стрима в формате OpenAI для цикла VibeOS
Сигнатуры мыслей Gemini 3

Для использования инструментов Gemini 3 VibeOS сохраняет значения thoughtSignature, прикреплённые к частям вызова функций, и воспроизводит их на следующем шаге инструмента. Это покрывает критический путь валидации для многошаговых рабочих процессов агентов.

Gemini 3 также может прикреплять сигнатуры мыслей к другим частям ответа. Нативный адаптер VibeOS сегодня оптимизирован для циклов инструментов агентов, поэтому он пока не воспроизводит каждую сигнатуру, не связанную с вызовом инструмента, с полной точностью на уровне частей.

Предпочитайте нативный эндпоинт​

Google также предоставляет OpenAI-совместимый эндпоинт:

https://generativelanguage.googleapis.com/v1beta/openai/

Для сессий агентов VibeOS предпочитайте указанный выше нативный эндпоинт Gemini. VibeOS включает нативный адаптер Gemini, чтобы напрямую отображать многошаговое использование инструментов, результаты вызовов инструментов, стриминг, мультимодальные входные данные и метаданные ответов Gemini на API generateContent. OpenAI-совместимый эндпоинт по-прежнему полезен, когда вам нужна совместимость с API OpenAI.

Если вы ранее установили GEMINI_BASE_URL на URL /openai, удалите его или измените:

GEMINI_BASE_URL=https://generativelanguage.googleapis.com/v1beta

Доступные модели​

Селектор vibeos model показывает модели Gemini, поддерживаемые в реестре провайдеров VibeOS. Распространённые варианты:

МодельIDПримечания
Gemini 3.1 Pro Previewgemini-3.1-pro-previewСамая производительная предварительная модель, когда доступна
Gemini 3 Pro Previewgemini-3-pro-previewМощная модель для рассуждений и кодирования
Gemini 3 Flash Previewgemini-3-flash-previewРекомендуемый баланс скорости и возможностей
Gemini 3.1 Flash Lite Previewgemini-3.1-flash-lite-previewСамый быстрый / недорогой вариант, когда доступен

Доступность моделей меняется со временем. Если модель исчезла или не включена для вашего ключа, снова запустите vibeos model и выберите одну из текущего списка.

Идентификаторы моделей

Используйте нативные идентификаторы моделей Gemini, такие как gemini-3-flash-preview, а не идентификаторы в стиле OpenRouter, например google/gemini-3-flash-preview, когда provider: gemini.

Последние псевдонимы​

Google публикует перемещаемые псевдонимы для семейств Pro и Flash Gemini. gemini-pro-latest и gemini-flash-latest полезны, когда вы хотите, чтобы Google автоматически обновлял модель без изменения вашей конфигурации VibeOS.

ПсевдонимТекущая привязкаПримечания
gemini-pro-latestПоследняя модель Gemini ProЛучший вариант, когда вам нужна текущая модель Pro от Google по умолчанию
gemini-flash-latestПоследняя модель Gemini FlashЛучший вариант, когда вам нужна текущая модель Flash от Google по умолчанию
model:
  default: gemini-pro-latest
  provider: gemini
  base_url: https://generativelanguage.googleapis.com/v1beta

Если вам нужна строгая воспроизводимость, предпочитайте явные идентификаторы моделей, такие как gemini-3.1-pro-preview или gemini-3-flash-preview.

Gemma через Gemini API​

Google также предоставляет модели Gemma через Gemini API. VibeOS распознаёт их как модели Google, но скрывает записи Gemma с очень низкой пропускной способностью из селектора моделей по умолчанию, чтобы новые пользователи случайно не выбрали модель оценочного уровня для длительной сессии агента.

Полезные идентификаторы для оценки:

МодельIDПримечания
Gemma 4 31B ITgemma-4-31b-itБолее крупная модель Gemma; полезна для оценки совместимости и качества
Gemma 4 26B A4B ITgemma-4-26b-a4b-itВариант с меньшим количеством активных параметров, когда доступен

Эти модели лучше всего рассматривать как варианты для оценки на ключах Gemini API. Ценообразование Gemma API от Google доступно только на бесплатном тарифе, и лимиты использования низки по сравнению с производственными моделями Gemini, поэтому для длительного использования агента VibeOS следует перейти на платную модель Gemini, собственное развёртывание или другого провайдера с соответствующими квотами.

Чтобы использовать модель Gemma, скрытую из селектора, укажите её напрямую:

model:
  default: gemma-4-31b-it
  provider: gemini
  base_url: https://generativelanguage.googleapis.com/v1beta

Переключение моделей во время сессии​

Используйте команду /model во время разговора:

/model gemini-3-flash-preview
/model gemini-flash-latest
/model gemini-3-pro-preview
/model gemini-pro-latest
/model gemma-4-31b-it
/model gemini-3.1-flash-lite-preview

Если вы ещё не настроили Gemini, выйдите из сессии и сначала выполните vibeos model. /model переключает между уже настроенными провайдерами и моделями; он не собирает новые API-ключи.

Диагностика​

vibeos doctor

Доктор проверяет:

  • Доступен ли GOOGLE_API_KEY или GEMINI_API_KEY
  • Можно ли разрешить учётные данные настроенного провайдера

Шлюз (Платформы обмена сообщениями)​

Gemini работает со всеми платформами шлюза VibeOS (Telegram, Discord, Slack, WhatsApp, LINE, Feishu и т. д.). Настройте Gemini как провайдера, затем запустите шлюз обычным образом:

vibeos gateway setup
vibeos gateway start

Шлюз читает config.yaml и использует ту же конфигурацию провайдера Gemini.

Устранение неполадок​

«Gemini native client requires an API key»​

VibeOS не смог найти используемый API-ключ. Добавьте один из них в ~/.vibeos/.env:

GOOGLE_API_KEY=...
# или
GEMINI_API_KEY=...

Затем снова выполните vibeos model.

«This Google API key is on the free tier»​

VibeOS проверяет ключи Gemini API во время настройки. Квоты бесплатного тарифа могут быть исчерпаны после нескольких шагов агента, поскольку использование инструментов, повторные попытки, сжатие и вспомогательные задачи могут потребовать нескольких вызовов модели.

Включите биллинг в проекте Google Cloud, привязанном к вашему ключу, при необходимости перегенерируйте ключ, затем выполните:

vibeos model

«404 model not found»​

Выбранная модель недоступна для вашей учётной записи, региона или ключа. Снова выполните vibeos model и выберите другую модель Gemini из текущего списка.

Модель Gemma не отображается в vibeos model​

VibeOS может по умолчанию скрывать модели Gemma с низкой пропускной способностью из селектора. Если вы намеренно хотите оценить одну из них, укажите идентификатор модели напрямую в ~/.vibeos/config.yaml.

«429 quota exceeded» на Gemma​

Модели Gemma, предоставляемые через Gemini API, полезны для оценки, но их лимиты бесплатного тарифа Gemini API низки. Используйте их для тестирования совместимости, затем переключитесь на платную модель Gemini или другого провайдера для длительных сессий агента.

Настроен OpenAI-совместимый эндпоинт​

Проверьте ~/.vibeos/.env на наличие:

GEMINI_BASE_URL=https://generativelanguage.googleapis.com/v1beta/openai/

Измените его на нативный эндпоинт или удалите переопределение:

GEMINI_BASE_URL=https://generativelanguage.googleapis.com/v1beta

Вызов инструментов завершается ошибками схемы​

Обновите VibeOS и повторно выполните vibeos model. Нативный адаптер Gemini очищает схемы инструментов для более строгого формата объявлений функций Gemini; старые сборки или пользовательские эндпоинты могут этого не делать.

Связанные разделы​