Gemini CLI

Use Gemini CLI com chave de gateway e API nativa v1beta.

Instalação e preparação

  1. Instale Node.js 20 ou posterior e o pacote npm oficial Gemini CLI abaixo. Confira gemini --version.
  2. Crie uma chave em routerra.ai Chaves de API para um modelo Gemini nativo de Modelos. A conexão usa Gemini generateContent/streamGenerateContent, não OpenAI Chat Completions.
npm install -g @google/gemini-cli
gemini --version

Configurar a rota Gemini nativa

  1. Defina as três variáveis no terminal de inicialização. O SDK acrescenta /v1beta/models/...; portanto, GOOGLE_GEMINI_BASE_URL deve ser https://routerra.ai, sem /v1 ou /v1beta. Substitua chave e modelo.
  2. Escolha Use Gemini API key; versões recentes podem detectar autenticação de gateway. Uma sessão Google ou Vertex existente pode ignorar essa rota: altere com /auth. Para persistência, grave linhas NAME=value em ~/.gemini/.env e reinicie. Não inclua esse arquivo em commits.
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

Para 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

Verificar a conexão

Teste um prompt curto com --model explícito. Uma página de login Google indica modo incorreto. /v1/v1beta ou /v1beta/v1beta revela um caminho extra. Se o modelo for rejeitado, confira Gemini nativo em vez de usar um ID OpenAI. Remova valores conflitantes de GOOGLE_GENAI_USE_VERTEXAI ou GOOGLE_GENAI_USE_GCA, reinicie e confira o uso no routerra.ai.