Khóa API Gemini — cách lấy và dùng với SDK OpenAI

Khóa API Gemini là thông tin xác thực dùng để xác thực các lệnh gọi của bạn đến các model Gemini của Google: mọi yêu cầu đều gửi khóa trong một header Authorization và mức sử dụng được đo lường, tính phí theo token. Có hai cách để lấy một khóa hoạt động: Google AI Studio (chính thức), cung cấp khóa chỉ dành cho Gemini, hoặc Kunavo, nơi một khóa duy nhất tương thích với OpenAI có thể truy cập Gemini, Claude, GPT cùng các model hình ảnh, video và âm thanh — không cần dự án Google Cloud. Hướng dẫn này cho biết cách lấy khóa theo cả hai cách và thực hiện lệnh gọi đầu tiên.

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

Đây là lựa chọn phù hợp nếu Gemini là model duy nhất bạn sẽ gọi.

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

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

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

Kunavo đặt Gemini phía sau một API tương thích với OpenAI. Một khóa duy nhất sk-kn- gọi được Gemini và tất cả model khác, với một ví duy nhất được tính phí qua Stripe và không cần bất kỳ dự án Google Cloud nào. Gemini có giá thấp hơn khoảng 70% so với giá niêm yết của Google — chẳng hạn Flash có giá $0,09 cho mỗi 1M token đầu vào và $0,75 cho mỗi 1M token đầu ra. Bạn thanh toán theo mức sử dụng từ khoản nạp tối thiểu $10, và số dư không bao giờ hết hạn.

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

Bắt đầu nhanh

Tiếp tục 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

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # a única linha que muda
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Explique RAG em duas frases."}],
)
print(resp.choices[0].message.content)

Bảo mật 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 biến môi trường, bên ngoài mã được quản lý phiên bản.
• Sử dụng một khóa cho mỗi dự án hoặc môi trường, để một lần rò rỉ có thể bị thu hồi mà không làm gián đoạn những phần còn lại.
• Xoay vòng định kỳ. Kunavo cho phép nhiều khóa hoạt động đồng thời, vì vậy việc xoay vòng là một quá trình chuyển đổi liền mạch thay vì ngắt đột ngột.
• Đặt giới hạn chi tiêu cho từng khóa trong dashboard và theo dõi /app/usage để phát hiện lưu lượng bất thường, được phân tách theo khóa.

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