Gemini CLI

Используйте Gemini CLI с ключом шлюза и нативным API v1beta.

Установка и подготовка

  1. Установите Node.js 20 или новее и официальный npm-пакет Gemini CLI ниже. Проверьте gemini --version.
  2. Создайте ключ в routerra.ai API-ключах для нативной модели Gemini из списка моделей. Соединение использует Gemini generateContent/streamGenerateContent, а не OpenAI Chat Completions.
npm install -g @google/gemini-cli
gemini --version

Нативный маршрут Gemini

  1. Задайте три переменные в терминале запуска. SDK добавляет /v1beta/models/..., поэтому GOOGLE_GEMINI_BASE_URL должен быть https://routerra.ai, без /v1 и /v1beta. Замените ключ и модель.
  2. Выберите Use Gemini API key; новые версии могут автоматически определить шлюзовую аутентификацию. Существующий вход Google или сеанс Vertex может обойти этот маршрут: переключите его через /auth. Для сохранения запишите строки NAME=value в ~/.gemini/.env и перезапустите. Не добавляйте файл в коммиты.
export GEMINI_API_KEY="YOUR_API_KEY"
export GOOGLE_GEMINI_BASE_URL="https://routerra.ai"
export GOOGLE_GENAI_API_VERSION="v1beta"
gemini --model YOUR_GEMINI_MODEL_ID

Для Windows PowerShell:

$env:GEMINI_API_KEY = "YOUR_API_KEY"
$env:GOOGLE_GEMINI_BASE_URL = "https://routerra.ai"
$env:GOOGLE_GENAI_API_VERSION = "v1beta"
gemini --model YOUR_GEMINI_MODEL_ID

Проверка подключения

Проверьте короткий запрос с явным --model. Страница входа Google означает неверный режим. /v1/v1beta или /v1beta/v1beta указывает на лишний путь URL. При отказе модели проверьте нативную поддержку Gemini вместо замены на ID OpenAI. Удалите конфликтующие GOOGLE_GENAI_USE_VERTEXAI или GOOGLE_GENAI_USE_GCA, перезапустите и проверьте расходы routerra.ai.