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

Khóa API Gemini xác thực các lệnh gọi của bạn đến các mô hình Gemini của Google: mỗi yêu cầu gửi khóa trong tiêu đề Authorization, và nền tảng đo lường cũng như tính phí mức sử dụng thông qua khóa đó. Có hai cách để nhận khóa API Gemini — trực tiếp qua Google AI Studio (cách chính thức), hoặc qua Kunavo: một khóa tương thích với OpenAI có thể truy cập Gemini cùng Claude, GPT và các mô hình hình ảnh, video mà không cần bất kỳ dự án Google Cloud nào.

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

Nếu Gemini là mô hình duy nhất bạn sẽ sử dụng, hãy lấy khóa trực tiếp từ Google:

1. Mở aistudio.google.com và đăng nhập bằng tài khoản Google.
2. Đi tới Get API key → Create API key. Các khóa bắt đầu bằng AIza… và chỉ được hiển thị một lần.
3. Gói miễn phí bị giới hạn tốc độ và phù hợp cho việc tạo nguyên mẫu. Khi dùng trong môi trường production, hãy liên kết khóa với tài khoản thanh toán Google Cloud.

Đây là lựa chọn phù hợp zolang bạn chỉ cần Gemini. Khi bắt đầu sử dụng cả Claude, GPT hoặc các mô hình hình ảnh và video, bạn sẽ phải quản lý một khóa, một SDK và một hóa đơn cho mỗi 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- có thể truy cập mọi mô hình trên cùng một endpoint — không cần dự án Google Cloud, Gemini thấp hơn khoảng 70% so với giá niêm yết của Google ($0,09 / $0,75 trên mỗi 1 triệu token), số dư Stripe và thanh toán theo mức sử dụng từ lần nạp $10. Số dư dùng chung cho Gemini, Claude, GPT, hình ảnh và video, đồng thời không bao giờ hết hạn.

1. Đăng ký. Tạo tài khoản Kunavo tại kunavo.com.
2. Nạp $10. Thanh toán theo mức sử dụng từ lần nạp tối thiểu $10; số dư không bao giờ 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 — hãy lưu khóa trong biến môi trường.
4. Gọi API. Trỏ SDK OpenAI đến https://api.kunavo.com/v1 và gọi một slug Gemini.

Bắt đầu nhanh

Giữ nguyên SDK OpenAI chính thức. Bạn chỉ cần thay đổi base_url và tên mô hình — 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",  # la seule ligne qui change
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Résume l'intrigue de Dune en deux phrases."}],
)
print(resp.choices[0].message.content)

Cùng một mẫu áp dụng cho Node.js và curl; giá theo từng mô hình và các ví dụ chi tiết có trong hướng dẫn giá API Gemini.

Bảo mật khóa

• Dùng biến môi trường, không dùng mã nguồn. Không bao giờ commit khóa vào kho lưu trữ; hãy đọc khóa từ biến môi trường. Tuyệt đối không để lộ khóa trong bundle trình duyệt hoặc ứng dụng di động — luôn đi qua máy chủ riêng của bạn.
• Mỗi dự án hoặc môi trường dùng một khóa. Khi một khóa bị lộ, bạn có thể thu hồi khóa đó mà không làm hỏng bất kỳ phần nào khác.
• Xoay vòng thường xuyên. Kunavo cho phép nhiều khóa hoạt động, vì vậy việc xoay vòng có thể diễn ra theo kiểu chuyển tiếp liền mạch thay vì gián đoạn đột ngột.
• Giới hạn chi tiêu theo từng khóa. Đặt giới hạn cho từng khóa trong dashboard và theo dõi lưu lượng bất thường theo khóa tại /app/usage.

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