Tài liệu

Tài liệu

Khóa API Gemini

Cách lấy khóa API Gemini và gọi các model Gemini Pro và Flash thông qua endpoint tương thích với OpenAI — gồm phương thức trực tiếp qua Google AI Studio và phương thức dùng một khóa Kunavo cũng truy cập được Claude, GPT-Image, Veo và Suno.

Khóa API Gemini là thông tin xác thực dùng để cấp quyền cho các lệnh gọi đến những model Gemini của Google. Bạn có thể lấy khóa trực tiếp từ Google AI Studio hoặc dùng một khóa sk-kn- duy nhất để truy cập Gemini qua cùng API tương thích với OpenAI mà bạn đã dùng cho mọi dịch vụ khác.

Tóm tắt — Đăng ký, tạo khóa tại /app/keys, đặt base_url=https://api.kunavo.com/v1, rồi gọi model="gemini-2-5-flash". Không cần dự án Google Cloud; cùng một khóa cũng dùng được cho Claude, GPT-Image và Veo.

Khóa API Gemini là gì

Khóa API Gemini là thông tin xác thực bearer cấp quyền cho các yêu cầu đến dòng model Gemini của Google. Mỗi yêu cầu gửi khóa trong tiêu đề Authorization; nền tảng tính mức sử dụng theo khóa đó và tính phí theo token. Hiện trên Kunavo, bạn có thể gọi gemini-3-1-pro và gemini-2-5-flash qua endpoint tương thích với OpenAI.

Có hai cách lấy khóa hoạt động, tùy bạn muốn dùng riêng Gemini hay dùng Gemini cùng các model tiên tiến khác.

Phương án A — khóa trực tiếp từ Google AI Studio

  1. Truy cập aistudio.google.com và đăng nhập bằng tài khoản Google.
  2. Mở Lấy khóa API → Tạo khóa API. Khóa có định dạng AIza....
  3. Để dùng với lưu lượng sản xuất, hãy 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 nếu Gemini là model duy nhất bạn sẽ dùng. Nếu dùng cả Claude, model hình ảnh hoặc video, bạn sẽ phải quản lý khóa, SDK và hóa đơn riêng cho từng nhà cung cấp.

Phương án B — một khóa Kunavo cho Gemini và mọi dịch vụ khác

Kunavo là cổng API AI độc lập, tương thích với OpenAI: một khóa API và một số dư thanh toán theo mức sử dụng cho phép truy cập Claude, GPT cùng các mô hình hình ảnh, video và âm thanh mà không cần tài khoản riêng cho từng nhà cung cấp.

Kunavo cung cấp Gemini thông qua API tương thích với OpenAI. Một khóa sk-kn- duy nhất truy cập được Gemini và mọi model khác, với số dư thanh toán tập trung qua Stripe.

Khóa Google AI StudioKhóa Kunavo
Mô hìnhChỉ GeminiGemini + Claude, GPT-Image, Veo, Suno
Điểm cuốiGoogle GenAI APIhttps://api.kunavo.com/v1
Thanh toánTài khoản Google CloudMột ví Stripe
Mức tối thiểu để bắt đầuGói miễn phí (có giới hạn tốc độ)Nạp $10, không hết hạn
Định dạng khóaAIza...sk-kn-...
  1. Tạo tài khoản Kunavo và nạp $10 — trả theo mức sử dụng, số dư không bao giờ hết hạn.
  2. Tạo khóa tại /app/keys. Khóa chỉ hiển thị một lần; hãy lưu vào biến môi trường.
  3. Trỏ OpenAI SDK đến https://api.kunavo.com/v1 và gọi một slug Gemini.

Gọi Gemini bằng Python

Tiếp tục dùng OpenAI SDK chính thức. Đổi base_url và tên model — không cần 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",  # the only line that changes
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Summarize the plot of Dune in two sentences."}],
)
print(resp.choices[0].message.content)

Gọi Gemini bằng Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.KUNAVO_API_KEY,
  baseURL: "https://api.kunavo.com/v1",
});

const resp = await client.chat.completions.create({
  model: "gemini-2-5-flash",
  messages: [{ role: "user", content: "Summarize the plot of Dune in two sentences." }],
});
console.log(resp.choices[0].message.content);
OpenAI SDK dùng baseURL trong Node và base_url trong Python. Cả hai đều trỏ đến cùng một endpoint.

Hoặc gọi bằng curl

curl https://api.kunavo.com/v1/chat/completions \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2-5-flash",
    "messages": [{"role": "user", "content": "Hello, Gemini"}]
  }'

Chọn model Gemini nào

  • gemini-2-5-flash — lựa chọn mặc định nhanh và cực kỳ tiết kiệm cho trò chuyện, trích xuất và tóm tắt.
  • gemini-3-1-pro — suy luận mạnh hơn, xử lý hình ảnh và phân tích ngữ cảnh dài.
Xem mức giá theo từng model và ví dụ chi phí cụ thể trong hướng dẫn giá API Gemini và trang giá.

Danh sách kiểm tra bảo mật

  • Không bao giờ để lộ khóa ở phía máy khách. Các gói ứng dụng trình duyệt và di động đều công khai — luôn chuyển tiếp yêu cầu qua máy chủ của bạn.
  • Dùng một khóa cho mỗi dự án hoặc môi trường để có thể thu hồi khóa bị lộ mà không làm gián đoạn mọi thứ khác.
  • Luân chuyển khóa mỗi quý. Kunavo cho phép nhiều khóa hoạt động cùng lúc, nên việc luân chuyển có thể diễn ra liền mạch thay vì chuyển đổi đột ngột.
  • 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

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

Google AI Studio cấp khóa miễn phí theo hạn mức thấp, phù hợp để tạo mẫu thử. Khi chuyển sang lưu lượng sản xuất, bạn cần dùng gói thanh toán trả phí. Trên Kunavo, bạn trả theo mức sử dụng, với khoản nạp tối thiểu $10 và không cần tài khoản thanh toán Google Cloud riêng — số dư không bao giờ hết hạn.

Tôi có thể dùng Gemini với OpenAI SDK không?

Có. Kunavo cung cấp Gemini qua endpoint /v1/chat/completions tương thích với OpenAI, vì vậy bạn có thể tiếp tục dùng OpenAI SDK chính thức và chỉ cần đổi base_url thành https://api.kunavo.com/v1, đồng thời đặt tên model thành một slug Gemini như gemini-2-5-flash.

Khóa API Google Gemini và khóa API Kunavo khác nhau thế nào?

Khóa Google chỉ gọi được Gemini và tính phí qua tài khoản Google Cloud. Khóa Kunavo gọi được Gemini cùng Claude, GPT-Image, Veo và Suno qua một API tương thích với OpenAI, với toàn bộ chi phí được thanh toán một lần qua Stripe.

Tôi nên bắt đầu với model Gemini nào?

Hãy bắt đầu với gemini-2-5-flash cho các tác vụ trò chuyện, trích xuất và tóm tắt hằng ngày — model này nhanh và có chi phí cực thấp. Chuyển sang gemini-3-1-pro khi cần suy luận phức tạp hơn, xử lý hình ảnh hoặc phân tích ngữ cảnh dài.

Tiếp theo nên xem gì