Gemini CLI

Gemini CLI é o agente open source do Google para o terminal. Com duas variáveis de ambiente você o aponta para a Synthorai, e ele passa a chamar o endpoint nativo do Gemini no gateway com a sua chave da Synthorai.

Antes de começar

Crie uma chave de API na página Chaves de API do console. Copie na hora: ela só aparece uma vez.

Passo 1 - Definir as variáveis de ambiente

export GOOGLE_GEMINI_BASE_URL="https://synthorai.io"
export GEMINI_API_KEY="sk-..."
gemini -m gemini-3-pro

⚠

Use só o host, sem /v1: o Gemini CLI acrescenta o próprio caminho.

Quando o Gemini CLI perguntar como autenticar, escolha Use Gemini API key. A chave vai no cabeçalho x-goog-api-key, que o gateway aceita no endpoint nativo do Gemini: /v1beta/models/{model}:generateContent e :streamGenerateContent.

Passo 2 - Escolher um modelo

Passe para -m um modelo Gemini que sua chave possa chamar. A página de modelos mostra quais são.

Neste caminho só são atendidos generateContent e streamGenerateContent. Outros métodos, como countTokens e embedContent, respondem 404 e não são cobrados.

Guardar as configurações em um arquivo

Em vez de exportar as variáveis em cada shell, você pode colocá-las em ~/.gemini/.env:

# ~/.gemini/.env
GOOGLE_GEMINI_BASE_URL="https://synthorai.io"
GEMINI_API_KEY="sk-..."

Solução de problemas

401 A chave está errada ou não está definida no shell que executa o gemini.

404 em um modelo Esse modelo não está liberado para a sua chave. Escolha um que ela possa chamar.

/v1/v1beta em uma URL Tire o /v1 de GOOGLE_GEMINI_BASE_URL.

Para comparar quanto custam os modelos Gemini, veja a comparação de preços de modelos.