⚡
OpenCodeDocs

Gemini API

Sử dụng Google Gemini API với OpenCode.

Tổng quan

Google Gemini là một trong những AI models mạnh nhất từ Google. OpenCode hỗ trợ Gemini qua Google Vertex AI hoặc OpenCode Zen.

Cách 1: Qua OpenCode Zen (Đơn giản nhất)

Nếu bạn muốn setup nhanh, sử dụng OpenCode Zen - đã có sẵn Gemini models.

  1. Truy cập opencode.ai/auth và lấy API key
  2. Kết nối trong OpenCode:
/connect

Chọn OpenCode Zen và paste API key.

  1. Chọn model:
/models

Tìm Gemini 3 Pro hoặc Gemini 3 Flash.

Cách 2: Qua Google Vertex AI

Nếu bạn muốn sử dụng trực tiếp qua Google Cloud.

Bước 1: Setup Google Cloud Project

  1. Truy cập console.cloud.google.com
  2. Tạo hoặc chọn project
  3. Enable Vertex AI API
  4. Vào Model Garden để xem models available trong region của bạn

Bước 2: Authentication

Có 2 cách authenticate:

Cách A: Dùng gcloud CLI

gcloud auth application-default login

Cách B: Dùng Service Account

  1. Tạo service account trong Google Cloud Console
  2. Download JSON key file
  3. Set environment variable:
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json

Bước 3: Set Environment Variables

export GOOGLE_CLOUD_PROJECT=your-project-id
export VERTEX_LOCATION=global  # hoặc us-central1, europe-west1...

Tip: Region global cải thiện availability và không tốn thêm chi phí.

Bước 4: Sử dụng trong OpenCode

/models

Tìm và chọn Gemini model.

Các Gemini Models

ModelĐặc điểmUse case
Gemini 3 ProMạnh nhất, context lớnComplex tasks, architecture
Gemini 3 FlashNhanh, rẻDaily coding, quick tasks

Cấu hình trong OpenCode

Thêm vào bash profile

# ~/.bashrc hoặc ~/.zshrc
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
export GOOGLE_CLOUD_PROJECT=your-project-id
export VERTEX_LOCATION=global

Hoặc chạy trực tiếp

GOOGLE_CLOUD_PROJECT=my-project opencode

Pricing (Tham khảo)

Qua OpenCode Zen

ModelInput/1M tokensOutput/1M tokens
Gemini 3 Pro (≤ 200K)$2.00$12.00
Gemini 3 Pro (> 200K)$4.00$18.00
Gemini 3 Flash$0.50$3.00

Qua Vertex AI

Xem cloud.google.com/vertex-ai/pricing để biết giá mới nhất.

Tips sử dụng

1. Chọn model phù hợp

  • Gemini Flash: Nhanh, rẻ - phù hợp cho daily coding
  • Gemini Pro: Mạnh hơn - cho complex analysis, long context

2. Sử dụng global region

export VERTEX_LOCATION=global

Region global tự động route đến data center gần nhất, cải thiện availability.

3. Set default model

Trong opencode.json:

{
  "model": "opencode/gemini-3-flash"
}

Hoặc nếu dùng Vertex AI trực tiếp:

{
  "model": "google-vertex/gemini-3-pro"
}

4. Cached reads

Gemini hỗ trợ cached reads với giá rẻ hơn 90%. Tự động được apply khi có thể.

So sánh Gemini vs Claude

GeminiClaude
Context size1M+ tokens200K tokens
SpeedRất nhanh (đặc biệt Flash)Nhanh
Coding qualityTốtRất tốt
GiáRẻ hơnĐắt hơn

Khuyến nghị:

  • Dùng Gemini Flash cho quick tasks
  • Dùng Claude Sonnet cho coding quality cao
  • Dùng Gemini Pro khi cần long context

Xử lý lỗi thường gặp

"Permission denied"

  • Kiểm tra service account có quyền Vertex AI User
  • Kiểm tra Vertex AI API đã được enable

"Model not found"

  • Kiểm tra model có available trong region của bạn
  • Thử đổi sang region global

"Quota exceeded"

  • Kiểm tra quota trong Google Cloud Console
  • Request quota increase nếu cần

Tham khảo