Kling 4.0 DISPONÍVEL — Vídeo incrivelmente real | Experimente →
Setup do agente

Conecte Gemini CLI à API LLM da WaveSpeed

Copie o setup ~/.gemini/.env recomendado para Gemini CLI, roteie requests para /v1beta/models/{model}:generateContent e verifique chamadas locais do agente em WaveSpeed Logs.

O agente de terminal de código aberto do Google; aponte-o para o endpoint compatível com Gemini da WaveSpeed.

Arquivo de configuração

~/.gemini/.env

Protocolo

Gemini generateContent API

Endpoint

/v1beta/models/{model}:generateContent

Configuração manual

1

Crie uma chave de acesso WaveSpeed

2

Exporte localmente a chave necessária

3

Cole a configuração em~/.gemini/.env

4

Execute gemini e confira Logs

Chat completions compatíveis com OpenAI

O uso aparece em Dashboard e Logs

Troque modelos sem reescrever o código do agente

Configuração com um único comando

Configura o Gemini CLI, verifica se funciona e faz backup das suas configurações anteriores. Adicione --undo para restaurá-las.

  1. 1

    Instale a CLI da WaveSpeed

    npm install -g @wavespeed/cli
  2. 2

    Entrar

    wavespeed login
  3. 3

    Configurar o Gemini CLI

    wavespeed setup gemini

Não tem Node.js? Veja outras opções de instalação

Configuração manual

Editar ~/.gemini/.env
# File: ~/.gemini/.env  (read only in folders Gemini CLI trusts)
GOOGLE_GEMINI_BASE_URL=https://llm.wavespeed.ai
GEMINI_API_KEY=wsk_live_...

# File: ~/.gemini/settings.json
{
  "security": { "auth": { "selectedType": "gemini-api-key" } },
  "model": { "name": "deepseek/deepseek-v4.1-flash-1017" }
}
Substitua wsk_live_... pela sua chave de API real da WaveSpeed antes de salvar este arquivo de configuração.

Guia de integração de agente

Use Gemini CLI com a API LLM da WaveSpeed

Este guia mostra como conectar Gemini CLI à WaveSpeed AI com ~/.gemini/.env, Gemini generateContent API, /v1beta/models/{model}:generateContent, base URL https://llm.wavespeed.ai/v1 e modelo padrão deepseek/deepseek-v4.1-flash-1017. Copie a configuração acima, exporte sua API key, execute o agente e verifique os requests em Logs.

1

Crie uma chave de acesso WaveSpeed

2

Exporte localmente a chave necessária

3

Cole a configuração em

~/.gemini/.env
4

Execute gemini e confira Logs

O que este setup de Gemini CLI configura

Protocolo

Gemini generateContent API

Endpoint

/v1beta/models/{model}:generateContent

Modelo

deepseek/deepseek-v4.1-flash-1017

A configuração pronta para copiar acima é o único arquivo Gemini CLI que você precisa editar no setup recomendado: ~/.gemini/.env. Mantenha a API key no ambiente shell para não enviá-la a um repositório.

Solução de problemas

A API key não está sendo lida

Exporte WAVESPEED_API_KEY na mesma shell em que você executa Gemini CLI. Se usar um perfil de shell, recarregue o terminal antes de iniciar o agente.

Requests falham com erro de protocolo ou endpoint

Confira se Gemini CLI está usando Gemini generateContent API e endpoint /v1beta/models/{model}:generateContent. Incompatibilidades de protocolo são a causa mais comum de erros 404 ou payload.

O modelo selecionado não funciona

Confirme que o ID do modelo existe em WaveSpeed Models e cole o ID exato em ~/.gemini/.env. Você pode começar com o modelo padrão mostrado nesta página.

Nenhum request aparece em Logs

Garanta que Gemini CLI use a base URL da WaveSpeed e sua API key atual. Depois envie um novo prompt pelo agente local e atualize Logs.

Este guia de Gemini CLI pode aparecer em buscas?

Sim. Esta página foi criada como um guia de setup indexável para usuários que pesquisam Gemini CLI custom provider, endpoint compatível com OpenAI, base URL e fluxos de configuração local de agentes.