Cách lấy khóa Gemini API — hai phương thức với Google AI Studio và Kunavo

Khóa API Gemini là thông tin xác thực bearer dùng để xác thực các lệnh gọi đến mô hình Gemini của Google. Có hai cách nhận khóa——từ Google AI Studio (chính thức), hoặc dùng một khóa tương thích OpenAI duy nhất của Kunavo để gọi Gemini, Claude, GPT và hình ảnh/video (không cần dự án Google Cloud). Hướng dẫn này trình bày cả hai quy trình và cách chọn phương án phù hợp cho môi trường production.

Phương pháp 1 — Google AI Studio (chính thức)

Nếu chỉ dùng Gemini, cách tiêu chuẩn là nhận khóa trực tiếp từ Google.

1. Đăng nhập aistudio.google.com bằng tài khoản Google.
2. Mở Get API key → Create API key. Khóa có dạng AIza....
3. Để tạo nguyên mẫu, bạn có thể dùng gói miễn phí có giới hạn tốc độ. Với lưu lượng production, bạn cần liên kết khóa với một dự án Google Cloud đã bật thanh toán.

Nếu mô hình bạn gọi chỉ là Gemini thì đây là lựa chọn phù hợp. Tuy nhiên, nếu dùng thêm Claude hoặc các mô hình hình ảnh/video, bạn sẽ phải quản lý khóa, SDK và hóa đơn riêng cho từng nhà cung cấp.

Phương pháp 2 — Kunavo (khuyến nghị cho production)

Kunavo cung cấp Gemini phía sau API tương thích OpenAI. Với một khóa sk-kn- duy nhất, bạn có thể truy cập Gemini và tất cả mô hình khác mà không cần dự án Google Cloud; thanh toán được gộp vào một số dư Stripe. Gemini rẻ hơn khoảng 70% so với bảng giá của Google và bạn có thể bắt đầu trả theo mức sử dụng từ $10.

1. Đăng ký — Tạo tài khoản tại kunavo.com.
2. Nạp $10 — Thanh toán theo mức sử dụng và số dư không hết hạn.
3. Tạo khóa — Tạo khóa tại /app/keys. Khóa bắt đầu bằng sk-kn- và chỉ hiển thị một lần, vì vậy hãy lưu khóa vào biến môi trường.
4. Gọi API — Trỏ base_url của OpenAI SDK đến https://api.kunavo.com/v1 và chỉ định slug Gemini.

Bạn cũng có thể xem bảng so sánh trong tài liệu khóa API Gemini để biết phương án nào phù hợp. Xem hướng dẫn giá API Gemini để biết chi tiết chi phí.

Bắt đầu nhanh

Sử dụng nguyên OpenAI SDK chính thức. Chỉ cần thay đổi base_url và tên mô hình.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # 変更するのはこの 1 行だけ
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",  # Gemini モデルのスラッグを指定
    messages=[{"role": "user", "content": "Gemini を一文で説明して。"}],
)
print(resp.choices[0].message.content)

Quản lý khóa an toàn

• Sử dụng biến môi trường. Không ghi trực tiếp khóa vào mã; hãy đọc khóa từ biến môi trường như KUNAVO_API_KEY. Vì gói trình duyệt và thiết bị di động đều có thể bị công khai, không để lộ khóa ở phía máy khách và luôn proxy qua máy chủ của bạn.
• Xoay vòng định kỳ. Kunavo cho phép nhiều khóa hoạt động đồng thời, nên việc xoay vòng có thể được thực hiện với khoảng thời gian chồng lấn liền mạch thay vì chuyển đổi đột ngột. Khuyến nghị thực hiện mỗi quý.
• Đặt giới hạn cho từng khóa. Đặt giới hạn theo khóa trong dashboard và tách khóa theo dự án hoặc môi trường. Nếu khóa bị lộ, bạn có thể vô hiệu hóa riêng khóa đó mà không dừng toàn bộ hệ thống. Theo dõi lưu lượng theo khóa tại /app/usage.

Câu hỏi thường gặp