Kling 4.0 is LIVE — Unbelievably Real Video | Try Now →
Agent Setup

Connect Gemini CLI to WaveSpeed LLM API

Copy the recommended ~/.gemini/.env setup for Gemini CLI, route requests to /v1beta/models/{model}:generateContent, and verify local agent calls in WaveSpeed Logs.

Google's open-source terminal agent; point it at WaveSpeed's Gemini-compatible endpoint.

Config file

~/.gemini/.env

Protocol

Gemini generateContent API

Endpoint

/v1beta/models/{model}:generateContent

Manual setup

1

Create a WaveSpeed access key

2

Export the required key locally

3

Paste config into~/.gemini/.env

4

Run gemini and check Logs

OpenAI-compatible chat completions

Usage appears in Dashboard and Logs

Switch models without rewriting agent code

One-command setup

Configures Gemini CLI, checks that it works, and backs up your previous settings. Add --undo to restore them.

  1. 1

    Install the WaveSpeed CLI

    npm install -g @wavespeed/cli
  2. 2

    Sign in

    wavespeed login
  3. 3

    Configure Gemini CLI

    wavespeed setup gemini

No Node.js? See other install options

Manual setup

Edit ~/.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" }
}
Replace wsk_live_... with your real WaveSpeed API key before saving this config file.

Agent integration guide

Use Gemini CLI with WaveSpeed LLM API

This guide shows how to connect Gemini CLI to WaveSpeed AI with ~/.gemini/.env, Gemini generateContent API, /v1beta/models/{model}:generateContent, base URL https://llm.wavespeed.ai/v1, and default model deepseek/deepseek-v4.1-flash-1017. Copy the configuration above, export your API key, run the agent, then verify requests in Logs.

1

Create a WaveSpeed access key

2

Export the required key locally

3

Paste config into

~/.gemini/.env
4

Run gemini and check Logs

What this Gemini CLI setup configures

Protocol

Gemini generateContent API

Endpoint

/v1beta/models/{model}:generateContent

Model

deepseek/deepseek-v4.1-flash-1017

The copy-ready configuration above is the only Gemini CLI file you need to edit for the recommended setup: ~/.gemini/.env. Keep the API key in your shell environment so it is not committed to a repository.

Troubleshooting

The API key is not being picked up

Export WAVESPEED_API_KEY in the same shell where you run Gemini CLI. If you use a shell profile, reload the terminal before starting the agent.

Requests fail with a protocol or endpoint error

Check that Gemini CLI is using Gemini generateContent API and endpoint /v1beta/models/{model}:generateContent. Protocol mismatches are the most common cause of 404 or payload errors.

The selected model does not work

Confirm the model id exists in WaveSpeed Models, then paste the exact id into ~/.gemini/.env. You can start with the default model shown on this page.

No requests appear in Logs

Make sure Gemini CLI is using the WaveSpeed base URL and your current API key. Then send a new prompt from the local agent and refresh Logs.

Can this Gemini CLI guide show up in search?

Yes. This page is built as an indexable setup guide for users searching for Gemini CLI custom provider, OpenAI-compatible endpoint, base URL, and local agent configuration workflows.