Kling 4.0 RA MẮT — Video chân thực khó tin | Dùng thử →
Setup agent

Kết nối Gemini CLI với WaveSpeed LLM API

Copy setup ~/.gemini/.env được khuyến nghị cho Gemini CLI, định tuyến request tới /v1beta/models/{model}:generateContent và xác minh các lệnh gọi agent local trong WaveSpeed Logs.

Tác nhân terminal mã nguồn mở của Google; trỏ nó tới endpoint tương thích Gemini của WaveSpeed.

File cấu hình

~/.gemini/.env

Giao thức

Gemini generateContent API

Endpoint

/v1beta/models/{model}:generateContent

Thiết lập thủ công

1

Tạo access key WaveSpeed

2

Export key cần thiết ở máy local

3

Dán cấu hình vào~/.gemini/.env

4

Chạy gemini và kiểm tra Logs

Chat completions tương thích OpenAI

Mức sử dụng hiển thị trong Dashboard và Logs

Đổi model mà không phải viết lại code agent

Thiết lập chỉ với một lệnh

Cấu hình Gemini CLI, kiểm tra xem nó có hoạt động không và sao lưu cài đặt cũ của bạn. Thêm --undo để khôi phục.

  1. 1

    Cài đặt WaveSpeed CLI

    npm install -g @wavespeed/cli
  2. 2

    Đăng nhập

    wavespeed login
  3. 3

    Cấu hình Gemini CLI

    wavespeed setup gemini

Không có Node.js? Xem các cách cài đặt khác

Thiết lập thủ công

Sửa ~/.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" }
}
Hãy thay wsk_live_... bằng khóa API WaveSpeed thật của bạn trước khi lưu tệp cấu hình này.

Hướng dẫn tích hợp agent

Dùng Gemini CLI với WaveSpeed LLM API

Hướng dẫn này chỉ cách kết nối Gemini CLI với WaveSpeed AI bằng ~/.gemini/.env, Gemini generateContent API, /v1beta/models/{model}:generateContent, base URL https://llm.wavespeed.ai/v1 và model mặc định deepseek/deepseek-v4.1-flash-1017. Copy cấu hình phía trên, export API key, chạy agent, rồi kiểm tra request trong Logs.

1

Tạo access key WaveSpeed

2

Export key cần thiết ở máy local

3

Dán cấu hình vào

~/.gemini/.env
4

Chạy gemini và kiểm tra Logs

Setup Gemini CLI này cấu hình gì

Giao thức

Gemini generateContent API

Endpoint

/v1beta/models/{model}:generateContent

Model

deepseek/deepseek-v4.1-flash-1017

Cấu hình sẵn để copy ở trên là file Gemini CLI duy nhất bạn cần sửa cho setup được khuyến nghị: ~/.gemini/.env. Giữ API key trong môi trường shell để không commit vào repository.

Xử lý sự cố

API key không được nhận

Export WAVESPEED_API_KEY trong cùng shell nơi bạn chạy Gemini CLI. Nếu dùng shell profile, hãy reload terminal trước khi khởi động agent.

Request lỗi protocol hoặc endpoint

Kiểm tra Gemini CLI đang dùng Gemini generateContent API và endpoint /v1beta/models/{model}:generateContent. Sai protocol là nguyên nhân phổ biến nhất của lỗi 404 hoặc payload.

Model đã chọn không hoạt động

Xác nhận model id tồn tại trong WaveSpeed Models, rồi dán đúng id vào ~/.gemini/.env. Bạn có thể bắt đầu với model mặc định hiển thị trên trang này.

Không thấy request trong Logs

Đảm bảo Gemini CLI dùng WaveSpeed base URL và API key hiện tại của bạn. Sau đó gửi prompt mới từ agent local và refresh Logs.

Hướng dẫn Gemini CLI này có thể xuất hiện trên tìm kiếm không?

Có. Trang này được xây dựng như một hướng dẫn setup có thể index cho người dùng tìm kiếm Gemini CLI custom provider, endpoint tương thích OpenAI, base URL và workflow cấu hình agent local.