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

Một Gemini API key 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 model Gemini của Google: mỗi yêu cầu gửi key trong header Authorization, và việc sử dụng được đo cũng như tính phí theo token. Có hai cách để lấy key hoạt động: Google AI Studio (chính thức), cấp key dành riêng cho Gemini; hoặc Kunavo, nơi một key 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 chỉ cách lấy key 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. Key có định dạng AIza....
3. Tier miễn phí có giới hạn và phù hợp cho prototype. Để có khối lượng production, key cần được liên kết với một dự án Google Cloud có tài khoản billing đang hoạt động.

Nếu bạn cũng sử dụng Claude, hình ảnh hoặc video, lựa chọn này khiến bạn phải quản lý key, 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 đặt Gemini phía sau một API tương thích với OpenAI. Một khóa sk-kn- gọi được Gemini và mọi mô hình 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 chính thức của Google — ví dụ, Flash có giá $0,09 cho mỗi 1 triệu token đầu vào và $0,75 cho mỗi 1 triệu token đầu ra. Đây là hình thức trả phí theo mức sử dụng, bắt đầu từ lầ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",  # satu-satunya baris yang berubah
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Jelaskan RAG dalam dua kalimat."}],
)
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