Tema
Idioma

Gemini CLI

Conecte o Gemini CLI à GetVibe API: GOOGLE_GEMINI_BASE_URL e GEMINI_API_KEY, qualquer modelo do catálogo pela API nativa do Gemini (generateContent, streamGenerateContent).

O Gemini CLI usa a API nativa do Gemini (/v1beta/models/…:streamGenerateContent, chave em x-goog-api-key). A API aceita esse protocolo e o processa pelo mesmo pipeline de /v1/chat/completions: qualquer modelo do catálogo funciona no Gemini CLI, não apenas o Gemini, com o mesmo faturamento, os mesmos limites e o mesmo histórico de Gerações.

Instalar

npm install -g @google/gemini-cli

Configuração

Selecione a autenticação por chave de API em ~/.gemini/settings.json — sem isso, o Gemini CLI no modo -p responde “Método de autenticação selecionado inválido”:

{
  "security": { "auth": { "selectedType": "gemini-api-key" } }
}

O endereço e a chave são definidos em variáveis de ambiente. A URL base não tem /v1beta: o próprio cliente acrescenta o caminho.

export GOOGLE_GEMINI_BASE_URL="https://getvibeapi.com"
export GEMINI_API_KEY="sk-pv-…"

Verificação

gemini -m deepseek-v4.1-flash -p "Reply: ready"

Escolha o modelo com -m ou model.name em settings.json — qualquer ID do catálogo funciona, inclusive um canal :suffix. As chamadas de ferramentas (leitura de arquivos, shell, edições) funcionam normalmente. Para execuções automatizadas fora de uma pasta confiável, adicione GEMINI_CLI_TRUST_WORKSPACE=true.

O que é compatível

ParâmetroTipoDescrição
:generateContent / :streamGenerateContentPOSTtexto, imagens (inlineData), systemInstruction, tools/functionDeclarations, toolConfig, responseSchema, thinkingConfig
:countTokensPOSTuma estimativa (~4 caracteres por token); a contagem exata está no usageMetadata da resposta
/v1beta/modelsGETa lista de modelos do catálogo no formato Gemini
Keyheaderx-goog-api-key, ?key= ou Authorization: Bearer — sua chave sk-pv-…
usageMetadata contém cachedContentTokenCount e thoughtsTokenCount. As ferramentas integradas do Google (googleSearch, codeExecution), a Files API, embedContent e os conteúdos em cache não são compatíveis: as ferramentas integradas são ignoradas silenciosamente, e os embeddings são disponibilizados em /v1/embeddings.

O mesmo endereço funciona para os SDKs @google/genai e google-genai: passe httpOptions: { baseUrl: 'https://getvibeapi.com' } (Python: http_options={'base_url': 'https://getvibeapi.com'}) e sua chave sk-pv-… como apiKey.

Gemini CLI + GetVibe API — API nativa do Gemini | GetVibe API