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.
Crie uma chave de acesso WaveSpeed
Exporte localmente a chave necessária
Cole a configuração em
~/.gemini/.envExecute 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.