Gemini CLI

Dùng Gemini CLI với khóa cổng và API v1beta gốc.

Cài đặt và chuẩn bị

  1. Cài Node.js 20 trở lên và gói npm Gemini CLI chính thức bên dưới. Kiểm tra gemini --version.
  2. Tạo khóa ở routerra.ai Khóa API cho mô hình Gemini gốc trong Mô hình. Kết nối dùng Gemini generateContent/streamGenerateContent, không phải OpenAI Chat Completions.
npm install -g @google/gemini-cli
gemini --version

Cấu hình định tuyến Gemini gốc

  1. Đặt ba biến trong terminal khởi chạy. SDK thêm /v1beta/models/..., nên GOOGLE_GEMINI_BASE_URL phải là https://routerra.ai, không có /v1 hoặc /v1beta. Thay khóa và mô hình.
  2. Chọn Use Gemini API key khi được hỏi; bản mới có thể tự nhận xác thực cổng. Phiên Google hoặc Vertex sẵn có có thể bỏ qua tuyến này: đổi bằng /auth. Để lưu lâu dài, ghi các dòng NAME=value vào ~/.gemini/.env rồi khởi động lại. Không commit tệp này.
export GEMINI_API_KEY="YOUR_API_KEY"
export GOOGLE_GEMINI_BASE_URL="https://routerra.ai"
export GOOGLE_GENAI_API_VERSION="v1beta"
gemini --model YOUR_GEMINI_MODEL_ID

Dành cho Windows PowerShell:

$env:GEMINI_API_KEY = "YOUR_API_KEY"
$env:GOOGLE_GEMINI_BASE_URL = "https://routerra.ai"
$env:GOOGLE_GENAI_API_VERSION = "v1beta"
gemini --model YOUR_GEMINI_MODEL_ID

Kiểm tra kết nối

Thử lời nhắc ngắn với --model cụ thể. Trang đăng nhập Google cho biết sai chế độ xác thực. /v1/v1beta hoặc /v1beta/v1beta nghĩa là URL có đường dẫn thừa. Nếu mô hình bị từ chối, kiểm tra Gemini gốc thay vì dùng ID OpenAI. Xóa các giá trị xung đột GOOGLE_GENAI_USE_VERTEXAI hoặc GOOGLE_GENAI_USE_GCA, khởi động lại và kiểm tra mức sử dụng routerra.ai.