Recursos para Desenvolvedores

Gemini CLI

Configure o Gemini CLI com a API Gemini nativa da RunAPI, verifique as solicitações e restaure sua configuração anterior.

Ver Markdown

Visão geral

O Gemini CLI é um agente de terminal. Este guia altera seu provedor de modelos para a API Gemini nativa da RunAPI; adicionar ferramentas da RunAPI via MCP é uma etapa separada.

Antes de começar

Siga o guia oficial de instalação. Crie uma chave de API padrão exclusiva com o guia de autenticação e copie um ID de modelo Gemini nativo do catálogo de modelos. Nunca inclua a chave em um commit.

SHELL

npm install -g @google/gemini-cli

Configurar o RunAPI

Comece com estas variáveis no shell atual. A URL base é a raiz HTTPS da API, sem /v1beta; o SDK acrescenta POST /v1beta/models/{model}:streamGenerateContent?alt=sse. HTTP só é permitido para localhost.

SHELL

export GOOGLE_GEMINI_BASE_URL=https://runapi.ai
export GEMINI_API_KEY=YOUR_RUNAPI_API_KEY
export GEMINI_MODEL=YOUR_RUNAPI_MODEL_ID

Para uso permanente, salve as mesmas três variáveis em ~/.gemini/.env, fora dos repositórios. Restrinja o acesso com chmod 600 ~/.gemini/.env. O Gemini CLI procura .env do diretório atual até os diretórios superiores e depois verifica ~/.gemini/.env e ~/.env; confira possíveis arquivos em conflito.

Mescle estas duas opções em ~/.gemini/settings.json, preservando as demais. Use gemini-api-key para autenticação por chave de API; não reutilize um login do Google armazenado. Por padrão, a chave é enviada em x-goog-api-key.

JSON

{
  "security": {
    "auth": {"selectedType": "gemini-api-key"}
  },
  "model": {"name": "YOUR_RUNAPI_MODEL_ID"}
}

Escolher um modelo

Use GEMINI_MODEL, --model YOUR_RUNAPI_MODEL_ID ou /model em uma sessão interativa. Evite auto, pro e flash: esses aliases podem apontar para IDs de modelos do Google indisponíveis na RunAPI. Seleção interna, classificação e detecção de loops também podem solicitar modelos auxiliares flash ou flash-lite; confira a disponibilidade separadamente.

Verificar

Execute isto em um repositório confiável. Confira o modelo com /about ou /stats em uma sessão interativa e confirme uma solicitação streamGenerateContent correspondente nos registros de uso da RunAPI. Uma resposta bem-sucedida da CLI não comprova sozinha qual endpoint a recebeu.

SHELL

gemini --version
gemini -p "Describe this repository in one sentence."

Adicionar ferramentas RunAPI

O MCP adiciona ferramentas, não um provedor de modelos. Este comando registra o servidor local; siga Local MCP para sua autenticação e verificação separadas.

SHELL

gemini mcp add runapi npx -y @runapi.ai/mcp

Solucionar problemas

Se as solicitações ainda vão ao Google, confira arquivos .env em conflito, security.auth.selectedType, o login armazenado e variáveis de autenticação Google/Vertex. Se aparecer Invalid auth method selected, selecione gemini-api-key em vez de gateway nas configurações e reinicie.

Em caso de 401, confira a chave e qualquer alteração de GEMINI_API_KEY_AUTH_MECHANISM; o padrão usa x-goog-api-key. Para 404, remova /v1beta da URL base e copie novamente um ID de modelo Gemini nativo compatível. Se um modelo auxiliar estiver indisponível, confira o ID solicitado; escolher o modelo principal não garante todas as funções da CLI.

A RunAPI não oferece countTokens nem embedContent. O Gemini CLI pode estimar tokens localmente quando countTokens falha; as estimativas podem diferir dos registros de uso. Use HTTPS, exceto para localhost, e não desative a verificação de certificados.

Remover RunAPI

Remova as três variáveis do shell e dos arquivos .env salvos, restaure security.auth.selectedType e o modelo anteriores e revogue a chave exclusiva na RunAPI. Remova o servidor MCP adicionado separadamente apenas se não precisar mais de suas ferramentas.

SHELL

unset GOOGLE_GEMINI_BASE_URL GEMINI_API_KEY GEMINI_MODEL

Próximas etapas

Continue com o início rápido da API LLM, Gemini generateContent, streamGenerateContent, o catálogo de modelos ou Local MCP.