Kling 4.0 ONLINE — Video incredibilmente reale | Provalo →
Setup agent

Connetti Gemini CLI alla WaveSpeed LLM API

Copia il setup ~/.gemini/.env consigliato per Gemini CLI, instrada le richieste a /v1beta/models/{model}:generateContent e verifica le chiamate agent locali in WaveSpeed Logs.

L'agente da terminale open source di Google; puntalo all'endpoint compatibile con Gemini di WaveSpeed.

File di configurazione

~/.gemini/.env

Protocollo

Gemini generateContent API

Endpoint

/v1beta/models/{model}:generateContent

Configurazione manuale

1

Crea una chiave di accesso WaveSpeed

2

Esporta localmente la chiave richiesta

3

Incolla la configurazione in~/.gemini/.env

4

Esegui gemini e controlla Logs

Chat completions compatibili con OpenAI

L’utilizzo appare in Dashboard e Logs

Cambia modello senza riscrivere il codice dell’agent

Configurazione con un solo comando

Configura Gemini CLI, verifica che funzioni ed esegue un backup delle impostazioni precedenti. Aggiungi --undo per ripristinarle.

  1. 1

    Installa la CLI di WaveSpeed

    npm install -g @wavespeed/cli
  2. 2

    Accedi

    wavespeed login
  3. 3

    Configura Gemini CLI

    wavespeed setup gemini

Non hai Node.js? Vedi le altre opzioni di installazione

Configurazione manuale

Modifica ~/.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" }
}
Sostituisci wsk_live_... con la tua vera chiave API WaveSpeed prima di salvare questo file di configurazione.

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.

1

Crea una chiave di accesso WaveSpeed

2

Esporta localmente la chiave richiesta

3

Incolla la configurazione in

~/.gemini/.env
4

Esegui 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.