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

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

Lựa chọn 1 — Google AI Studio (chính thức)

Đây là con đường phù hợp nếu Gemini là mô hình duy nhất bạn sẽ gọi.

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

Nếu bạn cũng dùng Claude, hình ảnh hay video, con đường này khiến bạn phải quản lý một khoá, một SDK và một hoá đơn riêng cho từng nhà cung cấp.

Lựa chọn 2 — Kunavo (khuyến nghị cho production)

Kunavo đặt Gemini sau một API tương thích OpenAI. Một khoá sk-kunavo- duy nhất gọi Gemini và mọi mô hình khác, với một ví duy nhất 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 — Flash chẳng hạn có giá $0.09 cho mỗi 1 triệu token đầu vào và $0.75 cho mỗi 1 triệu đầu ra. Đây là dùng đến đâu trả đến đó từ mức nạp tối thiểu $5, và số dư không bao giờ hết hạn.

1. Đăng ký tại kunavo.com.
2. Nạp $5 — dùng đến đâu trả đến đó, số dư không bao giờ hết hạn.
3. Tạo khoá tại /app/keys. Khoá bắt đầu bằng sk-kunavo- và chỉ hiển thị một lần; hãy lưu nó vào một biến môi trường.
4. Gọi bằng cách trỏ SDK OpenAI tới https://api.kunavo.com/v1 và dùng một slug Gemini.

Quickstart

Giữ nguyên SDK chính thức của OpenAI. Đổi base_url và tên mô hình — chỉ vậy thôi:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # dòng duy nhất thay đổi
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Giải thích RAG trong hai câu."}],
)
print(resp.choices[0].message.content)

Bảo mật khoá

• Đừng bao giờ để lộ khoá ở phía client. Bundle của trình duyệt và mobile đều công khai — hãy luôn proxy qua máy chủ của chính bạn. Lưu khoá trong biến môi trường, nằm ngoài mã được quản lý phiên bản.
• Dùng một khoá cho mỗi dự án hoặc môi trường, để khi rò rỉ có thể thu hồi mà không làm sập phần còn lại.
• Xoay khoá định kỳ. Kunavo cho phép nhiều khoá hoạt động cùng lúc, nên việc xoay khoá là một bước chuyển tiếp gọn gàng, không phải cắt đứt đột ngột.
• Đặt hạn mức chi tiêu cho mỗi khoá trong dashboard và theo dõi /app/usage để phát hiện lưu lượng bất thường, tách theo từng khoá.

FAQ

Gemini API có miễn phí không?

Google AI Studio cấp một khoá bậc miễn phí với giới hạn thấp, tốt cho nguyên mẫu; production chuyển sang thanh toán trả phí trên Google Cloud. Trên Kunavo là dùng đến đâu trả đến đó từ mức nạp tối thiểu $5, không cần tài khoản thanh toán Google Cloud, và số dư không bao giờ hết hạn.

Có thể lấy khoá mà không cần tài khoản Google Cloud không?

Có. Trên Kunavo bạn tạo một khoá sk-kunavo- và gọi Gemini qua endpoint tương thích OpenAI, không cần mở dự án hay bật thanh toán trên Google Cloud.

Khoá Gemini với khoá Kunavo?

Khoá của Google chỉ gọi Gemini và tính phí qua một tài khoản Google Cloud. Khoá Kunavo gọi Gemini cùng Claude, GPT và các mô hình hình ảnh, video, âm thanh qua một API tương thích OpenAI duy nhất, với một ví duy nhất qua Stripe. Để xem mức giá theo mô hình và ví dụ chi phí, xem hướng dẫn giá Gemini API.