Cách cấp khóa API Gemini — Google AI Studio và Kunavo

Khóa API Gemini là thông tin xác thực bearer dùng để xác thực lệnh gọi đến các mô hình Gemini của Google. Có hai cách nhận khóa — nhận khóa chính thức từ Google AI Studio hoặc dùng một khóa tương thích OpenAI duy nhất tại 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 so sánh hai phương án và chỉ ra cách nhanh nhất để bắt đầu gọi API ngay trong production.

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

Nếu dự định chỉ gọi Gemini, nhận khóa trực tiếp từ Google là lựa chọn phù hợp.

1. Truy cập aistudio.google.com và đăng nhập bằng tài khoản Google.
2. Tạo khóa bằng cách mở Get API key → Create API key. Khóa có dạng AIza....
3. Gói miễn phí dành cho việc tạo nguyên mẫu có giới hạn yêu cầu, phù hợp cho giai đoạn phát triển ban đầu.
4. Để xử lý lưu lượng production, bạn phải liên kết khóa với tài khoản thanh toán Google Cloud đã bật thanh toán.

Nếu Gemini tiếp tục là mô hình duy nhất được gọi, đây là con đường 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 đặt Gemini phía sau endpoint tương thích OpenAI. Một khóa sk-kn- duy nhất cho phép gọi tất cả mô hình và thanh toán bằng một số dư Stripe, vì vậy không cần dự án Google Cloud. Gemini rẻ hơn khoảng 70% so với giá niêm yết của Google; số dư không hết hạn và bạn trả theo mức sử dụng từ lần nạp tối thiểu $10.

1. Đăng ký — Tạo tài khoản tại kunavo.com.
2. Nạp $10 — Trả 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 vào biến môi trường.
4. Gọi API — Đặt base_url của OpenAI SDK thành https://api.kunavo.com/v1 rồi gọi bằng slug Gemini.

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 — không cần thay đổi gì khác.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # 바뀌는 건 이 줄뿐입니다
)

# 모델 슬러그만 바꾸면 Claude, GPT 등 다른 모델도 같은 키로 호출됩니다
resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "두 문장으로 자기소개를 해줘."}],
)
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 hard-code khóa trong mã; hãy lưu khóa trong biến môi trường như KUNAVO_API_KEY. Vì gói trình duyệt và thiết bị di động có thể bị công khai, tuyệt đối không để lộ khóa ở phía máy khách và luôn proxy qua máy chủ riêng.
• Xoay vòng định kỳ. Kunavo cho phép nhiều khóa hoạt động, nên bạn có thể xoay vòng 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ị xoay vòng mỗi quý.
• Đặt giới hạn chi tiêu theo khóa. Chỉ định giới hạn chi tiêu cho từng khóa trong dashboard và kiểm tra mức sử dụng theo khóa tại /app/usage; nếu khóa bị lộ, bạn có thể hủy riêng khóa đó mà không ảnh hưởng đến các khóa khác.

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