Guida integrazione agent
Usa Gemini CLI con la WaveSpeed LLM API
Questa guida mostra come collegare Gemini CLI a WaveSpeed AI con ~/.gemini/.env, Gemini generateContent API, /v1beta/models/{model}:generateContent, base URL https://llm.wavespeed.ai/v1 e modello predefinito deepseek/deepseek-v4.1-flash-1017. Copia la configurazione sopra, esporta la tua API key, avvia l’agent e verifica le richieste in Logs.
Crea una chiave di accesso WaveSpeed
Esporta localmente la chiave richiesta
Incolla la configurazione in
~/.gemini/.envEsegui gemini e controlla Logs
Cosa configura questo setup di Gemini CLI
Protocollo
Gemini generateContent API
Endpoint
/v1beta/models/{model}:generateContent
Modello
deepseek/deepseek-v4.1-flash-1017
La configurazione pronta da copiare sopra è l’unico file Gemini CLI da modificare per il setup consigliato: ~/.gemini/.env. Mantieni la API key nell’ambiente shell per non committarla in un repository.
Risoluzione problemi
La API key non viene letta
Esporta WAVESPEED_API_KEY nella stessa shell in cui esegui Gemini CLI. Se usi un profilo shell, ricarica il terminale prima di avviare l’agent.
Le richieste falliscono con errore di protocollo o endpoint
Controlla che Gemini CLI usi Gemini generateContent API ed endpoint /v1beta/models/{model}:generateContent. Le discrepanze di protocollo sono la causa più comune di errori 404 o payload.
Il modello selezionato non funziona
Conferma che l’ID modello esista in WaveSpeed Models, poi incolla l’ID esatto in ~/.gemini/.env. Puoi iniziare dal modello predefinito mostrato in questa pagina.
In Logs non appare alcuna richiesta
Assicurati che Gemini CLI usi la base URL WaveSpeed e la tua API key attuale. Poi invia un nuovo prompt dall’agent locale e aggiorna Logs.
Questa guida Gemini CLI può apparire nei motori di ricerca?
Sì. Questa pagina è costruita come guida di setup indicizzabile per utenti che cercano Gemini CLI custom provider, endpoint compatibile OpenAI, base URL e workflow di configurazione agent locale.