Cách lấy khóa API Gemini — từng bướ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 của bạn đến các model Gemini của Google. Có hai cách để lấy khóa: trực tiếp từ Google AI Studio (cách chính thức) hoặc qua Kunavo — một khóa duy nhất tương thích với OpenAI cho Gemini, Claude, GPT và hình ảnh/video, mà không cần thiết lập dự án Google Cloud. Hướng dẫn này trình bày từng bước cả hai cách và giúp bạn gọi Gemini trong vài phút.

Tùy chọn 1 — Google AI Studio (chính thức)

Nếu chỉ sử dụng Gemini, bạn có thể lấy khóa trực tiếp từ Google:

1. Đăng nhập vào địa chỉ aistudio.google.com bằng tài khoản Google.
2. Đi theo đường dẫn Get API key → Create API key. Các khóa bắt đầu bằng AIza....
3. Có một cấp miễn phí bị giới hạn và giới hạn tốc độ, phù hợp cho việc tạo prototype.
4. Để sử dụng production, bạn phải liên kết khóa với một dự án Google Cloud đã bật thanh toán.

Đây là lựa chọn phù hợp khi Gemini là model duy nhất bạn sẽ gọi. Nếu bạn cũng sử dụng các model Claude, hình ảnh hoặc video, bạn sẽ phải quản lý một khóa, SDK và hóa đơn riêng cho từng nhà cung cấp.

Tùy chọn 2 — Kunavo (khuyến nghị cho production)

Kunavo cung cấp Gemini phía sau một API tương thích với OpenAI. Một khóa sk-kn- duy nhất có thể truy cập Gemini và mọi model khác (thông qua endpoint tương thích với OpenAI) — không cần dự án Google Cloud. Gemini có giá thấp hơn khoảng 70% so với giá của Google, một số dư Stripe duy nhất bao phủ mọi thứ và bạn bắt đầu thanh toán theo mức sử dụng từ $10.

1. Tạo tài khoản Kunavo và nạp $10 — thanh toán theo mức sử dụng, số dư không bao giờ hết hạn.
2. Tạo khóa tại trang /app/keys. Khóa chỉ được hiển thị một lần; hãy lưu khóa trong một biến môi trường.
3. Trỏ SDK OpenAI đến địa chỉ https://api.kunavo.com/v1 và gọi một slug Gemini.
4. Gọi — gửi trường model với giá trị như gemini-2-5-flash, vậy là xong.

Bắt đầu nhanh

Bạn vẫn sử dụng SDK OpenAI chính thức. Chỉ thay đổi base_url và tên model — không thay đổi gì khác:

import os
from openai import OpenAI

# Resmi OpenAI SDK'sını koruyun; yalnızca base_url ve model değişir.
client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # değişen tek satır
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Merhaba Gemini, kendini bir cümleyle tanıt."}],
)
print(resp.choices[0].message.content)

Giữ an toàn cho khóa

• Không bao giờ để lộ khóa ở phía máy khách. Các bundle trình duyệt và mobile đều công khai — luôn proxy qua máy chủ của riêng bạn. Lưu khóa trong các tệp .env và biến môi trường, không bao giờ nhúng khóa vào mã nguồn.
• Sử dụng một khóa riêng cho mỗi dự án hoặc môi trường để một lần rò rỉ có thể bị hủy mà không vô hiệu hóa mọi thứ khác.
• Xoay vòng thường xuyên. Kunavo cho phép nhiều khóa đang hoạt động cùng lúc; nhờ đó việc xoay vòng trở thành một quá trình chuyển tiếp chồng lấp liền mạch thay vì gián đoạn đột ngột.
• Đặt giới hạn chi tiêu cho từng khóa. Đặt giới hạn cho từng khóa qua dashboard và theo dõi lưu lượng bất thường theo khóa trên trang /app/usage.

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