Cách lấy khóa Google Gemini API (2026): Tạo, kiểm thử và bảo mật cho môi trường production
Để lấy khóa Google Gemini API, hãy đăng nhập vào Google AI Studio bằng tài khoản Google, chấp nhận điều khoản, mở trang API Keys và nhấp vào Tạo khóa API; người dùng mới sẽ tự động được tạo một dự án Google Cloud mặc định cùng một khóa. Việc tạo khóa là miễn phí, và một số mô hình Gemini, bao gồm Gemini 3.8 Flash và Gemini 3.5 Flash-Lite, có gói miễn phí. Kể từ ngày 28 tháng 5 năm 2026, mọi khóa mới được tạo trong AI Studio đều là “khóa ủy quyền” gắn với một tài khoản dịch vụ, và Gemini API từ chối các khóa cũ không có hạn chế. Vì vậy, khóa vẫn dùng được năm ngoái có thể cần được thay thế (tài liệu về khóa API của Google, kiểm tra ngày 27 tháng 10 năm 2026).
Hướng dẫn này dành cho lập trình viên độc lập và các nhóm nhỏ muốn có khóa Gemini hoạt động trong vài phút và sử dụng an toàn trong môi trường production. Nội dung bao gồm các bước thực hiện, những loại khóa mới, gói miễn phí, yêu cầu đầu tiên bằng curl, Python và Node.js, những lỗi thường gặp nhất và danh sách kiểm tra trước khi đưa vào production. Nếu bạn đang so sánh chi phí, hướng dẫn về giá Gemini API của chúng tôi có bảng giá đầy đủ.
Cách lấy khóa Gemini API từng bước
- Mở Google AI Studio. Truy cập aistudio.google.com/apikey và đăng nhập bằng tài khoản Google bạn muốn dùng để thanh toán hoặc sở hữu dự án.
- Chấp nhận điều khoản. Nếu bạn là người dùng mới, AI Studio sẽ tạo một dự án Google Cloud mặc định và một khóa API sau khi bạn chấp nhận Điều khoản dịch vụ. Bạn có thể đổi tên dự án sau trong mục Dự án.
- Chọn hoặc nhập dự án. Nếu bạn đã sử dụng Google Cloud, AI Studio sẽ không tạo dự án mặc định. Mở Bảng điều khiển → Dự án → Nhập dự án, rồi chọn dự án Cloud mong muốn.
- Tạo khóa. Trên trang API Keys, nhấp vào Tạo khóa API rồi chọn dự án. Theo mặc định, khóa mới là khóa ủy quyền.
- Sao chép khóa và lưu ngay. Đưa khóa vào biến môi trường hoặc trình quản lý bí mật ngay lập tức, đừng lưu trong tệp thuộc kho mã nguồn.
- Áp dụng hạn chế cho khóa. Nếu khóa chỉ dùng để gọi Gemini, hãy giới hạn khóa cho Gemini API (Generative Language API). Nếu khóa được dùng từ các máy chủ cố định, hãy thêm hạn chế theo IP trong bảng điều khiển Google Cloud.
- Kiểm thử khóa bằng một trong các yêu cầu bên dưới.
Các bước dựa trên tài liệu Sử dụng khóa Gemini API của Google AI for Developers, cập nhật lần cuối ngày 27 tháng 10 năm 2026.
Sau này tôi có thể tìm khóa Google API của mình ở đâu?
Trong Google AI Studio, mở Bảng điều khiển → API Keys. AI Studio hiển thị tối đa 100 khóa và 50 dự án, đồng thời chỉ liệt kê các khóa không có hạn chế hoặc được giới hạn cho Gemini API. Các khóa bị giới hạn cho những Google API khác chỉ xuất hiện trên trang thông tin xác thực của bảng điều khiển Google Cloud. Nếu không thấy dự án, hãy nhập dự án đó trước.
Khóa tiêu chuẩn và khóa ủy quyền: những thay đổi trong năm 2026
Google đang chuyển Gemini API từ khóa API tiêu chuẩn sang khóa ủy quyền (auth). Theo tài liệu chính thức (ngày 27 tháng 10 năm 2026):
| Khóa API tiêu chuẩn | Khóa ủy quyền | |
|---|---|---|
| Được gắn với | Một dự án Google Cloud, phục vụ thanh toán và hạn ngạch | Một tài khoản dịch vụ Google Cloud |
| Xác định danh tính bên gọi | Không | Có, yêu cầu được thực thi dưới danh tính tài khoản dịch vụ đã liên kết |
| Phạm vi mặc định | Tùy thuộc vào các hạn chế bạn thêm | Mặc định được giới hạn cho Gemini API |
| Xử lý khóa bị lộ | Thủ công | Cơ chế thực thi nhanh chóng chặn việc sử dụng các khóa bị lộ mà Google phát hiện |
| Được AI Studio tạo | Trước ngày 28 tháng 5 năm 2026 | Từ ngày 28 tháng 5 năm 2026 |
| Còn hoạt động không? | Chỉ khi được áp dụng hạn chế rõ ràng | Có |
Ý nghĩa trong thực tế:
- Khóa tiêu chuẩn không có hạn chế sẽ bị từ chối. Nếu khóa cũ không có hạn chế theo API, các yêu cầu Gemini sẽ thất bại. Khắc phục trong AI Studio: di chuột lên nhãn cảnh báo của khóa và chọn Chỉ giới hạn cho Gemini API. Bạn cần quyền
apikeys.keys.update. - Khóa không có hạn chế và lâu không sử dụng sẽ bị chặn. Kể từ ngày 7 tháng 5 năm 2026, các khóa không có hạn chế và đã lâu không được sử dụng sẽ có nhãn Bị chặn. Hãy tạo khóa mới và chuyển ứng dụng sang dùng khóa đó.
- Tiền tố khóa mới. Các lập trình viên cho biết khóa auth mới không còn bắt đầu bằng tiền tố
AIzaquen thuộc (bài viết minh họa). Nếu một công cụ bên thứ ba xác thực khóa theo tiền tố, công cụ đó có thể từ chối khóa mới hợp lệ. Hãy cập nhật công cụ thay vì quay lại dùng khóa tiêu chuẩn. - Quyền tạo khóa. Nếu nút Tạo báo rằng bạn không có quyền, quản trị viên Cloud cần cấp cho bạn một vai trò có các quyền như
apikeys.keys.create,serviceusage.services.enable,iam.serviceAccounts.createvàiam.serviceAccountApiKeyBindings.create, cùng một số quyền khác. Nếu không có quyền quản trị, bạn có thể tạo một dự án mới không thuộc tổ chức nào.
Đặt khóa vào biến môi trường
Các thư viện máy khách của Google tự động đọc GEMINI_API_KEY hoặc GOOGLE_API_KEY. Nếu cả hai đều được đặt, GOOGLE_API_KEY sẽ được ưu tiên, và đây là nguyên nhân phổ biến khiến “khóa mới của tôi không được sử dụng”.
# macOS / Linux (add to ~/.zshrc or ~/.bashrc, then open a new terminal)
export GEMINI_API_KEY="paste-your-key-here"
# Make sure an old key is not overriding it
unset GOOGLE_API_KEY
Trên Windows, thêm GEMINI_API_KEY trong Thuộc tính hệ thống → Biến môi trường rồi mở một cửa sổ terminal mới.
Kiểm thử khóa Gemini API
curl (Interactions API)
Hướng dẫn bắt đầu nhanh hiện tại của Google sử dụng endpoint Interactions với khóa đặt trong header x-goog-api-key:
curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-d '{
"model": "gemini-3.8-flash",
"input": "Reply with the single word: ok"
}'
Phản hồi JSON có văn bản đầu ra cho thấy khóa, dự án và quyền truy cập mô hình đều hoạt động. Mã 403 thường có nghĩa là khóa bị giới hạn cho các API khác hoặc đã bị chặn; mã 429 nghĩa là bạn đã chạm giới hạn tốc độ (xem bên dưới).
Python (google-genai SDK)
# pip install google-genai
from google import genai
client = genai.Client() # reads GEMINI_API_KEY from the environment
interaction = client.interactions.create(
model="gemini-3.8-flash",
input="Explain what an API key is in one sentence.",
)
print(interaction.output_text)
Node.js (@google/genai)
// npm install @google/genai
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
const interaction = await ai.interactions.create({
model: "gemini-3.8-flash",
input: "Explain what an API key is in one sentence.",
});
console.log(interaction.output_text);
Dùng cùng khóa đó với OpenAI SDK
Gemini cũng cung cấp một endpoint tương thích với OpenAI. Endpoint này hữu ích cho các công cụ chỉ chấp nhận URL cơ sở của OpenAI, chẳng hạn như nhiều tác nhân lập trình và ứng dụng trò chuyện:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["GEMINI_API_KEY"],
base_url="https://generativelanguage.googleapis.com/v1beta/openai/",
)
resp = client.chat.completions.create(
model="gemini-3.8-flash",
messages=[{"role": "user", "content": "Say ok"}],
)
print(resp.choices[0].message.content)
Để xem cách thiết lập từng công cụ thông qua một cổng chung, hãy đọc Sử dụng Gemini API qua bộ định tuyến tương thích với OpenAI.
Khóa Gemini API có miễn phí không?
Khóa được cung cấp miễn phí, cùng với một gói miễn phí có giới hạn. Trang giá của Google (kiểm tra ngày 27 tháng 10 năm 2026) mô tả ba gói: Miễn phí, Trả phí và Doanh nghiệp. Gói miễn phí cung cấp token đầu vào và đầu ra miễn phí trên một số mô hình, nhưng nội dung gửi qua gói miễn phí được sử dụng để cải thiện các sản phẩm của Google. Với gói trả phí thì không. Đừng gửi dữ liệu khách hàng bằng khóa thuộc gói miễn phí.
| Mô hình | Gói miễn phí | Giá đầu vào / đầu ra trả phí cho mỗi 1M token (Tiêu chuẩn) |
|---|---|---|
| Gemini 4 Argon | Không có | $2.00 / $10.00 đến hết ngày 30 tháng 11 năm 2026; $4.00 / $20.00 từ ngày 1 tháng 12 năm 2026 |
| Gemini 3.8 Flash | Có | $0.75 / $3.75 đến hết ngày 31 tháng 12 năm 2026; $1.50 / $7.50 từ ngày 1 tháng 1 năm 2027 |
| Gemini 3.5 Flash-Lite | Có | $0.30 / $2.50 |
| Gemini 3.1 Flash-Lite | Có | $0.25 / $1.50 (văn bản, hình ảnh, video) |
Nguồn: Giá Gemini Developer API, ngày 27 tháng 10 năm 2026. Lưu ý các đợt tăng giá theo lịch: hãy dự trù ngân sách theo mức giá cao hơn nếu ứng dụng của bạn tiếp tục chạy sau những ngày đó.
Cách sử dụng Gemini API miễn phí
- Tạo khóa trong AI Studio mà không liên kết thanh toán. Dự án sẽ ở gói Miễn phí.
- Sử dụng mô hình có gói miễn phí, chẳng hạn như
gemini-3.8-flashhoặcgemini-3.5-flash-lite. Gemini 4 Argon chỉ có ở gói trả phí. - Tuân thủ giới hạn tốc độ của gói miễn phí hiển thị trong AI Studio. Giới hạn áp dụng theo dự án, không phải theo khóa, nên tạo thêm khóa trong cùng một dự án không làm tăng hạn ngạch.
- Chỉ sử dụng dữ liệu thử nghiệm hoặc dữ liệu công khai, vì nội dung của gói miễn phí có thể được dùng để cải thiện các sản phẩm của Google.
Giới hạn tốc độ và các cấp sử dụng
Giới hạn tốc độ của Gemini được đo bằng số yêu cầu mỗi phút (RPM), số token đầu vào mỗi phút (TPM) và số yêu cầu mỗi ngày (RPD). Vượt bất kỳ giới hạn nào cũng sẽ trả về lỗi, và RPD được đặt lại vào nửa đêm theo giờ Thái Bình Dương (giới hạn tốc độ, ngày 27 tháng 10 năm 2026). Google còn áp dụng giới hạn theo mức chi tiêu trong cửa sổ trượt 10 phút; khi vượt giới hạn này, API trả về 429 RESOURCE_EXHAUSTED.
| Cấp | Điều kiện đạt cấp | Trần thanh toán theo cấp |
|---|---|---|
| Miễn phí | Dự án đang hoạt động hoặc đang dùng thử miễn phí | Không áp dụng |
| Cấp 1 | Liên kết tài khoản thanh toán đang hoạt động | $250 |
| Cấp 2 | Đã thanh toán $100 + 3 ngày kể từ lần thanh toán thành công đầu tiên | $2,000 |
| Cấp 3 | Đã thanh toán $1,000 + 30 ngày kể từ lần thanh toán thành công đầu tiên | $20,000 đến $100,000+ |
Nguồn: Giới hạn tốc độ của Gemini API, ngày 27 tháng 10 năm 2026. Hãy kiểm tra giới hạn chính xác cho từng mô hình trong AI Studio; Google cho biết các giới hạn được liệt kê không được bảo đảm.
Người khác có thể làm gì với khóa API của bạn?
Bất kỳ ai có khóa Gemini của bạn đều có thể gửi yêu cầu được tính phí vào dự án của bạn và dùng hết hạn ngạch. Tài liệu của Google cảnh báo rằng khóa bị lộ có thể dẫn đến “các khoản phí ngoài dự kiến” và việc truy cập dữ liệu riêng tư trong dự án. Với khóa ủy quyền, kẻ tấn công hoạt động dưới danh tính tài khoản dịch vụ đã liên kết và có thể truy cập mọi tài nguyên mà tài khoản đó có quyền truy cập (các phương pháp sử dụng khóa API an toàn của Google Cloud). Vì vậy, bạn nên giới hạn quyền của tài khoản dịch vụ ở mức tối thiểu.
Nếu bạn nghi ngờ khóa bị lộ:
- Tạo khóa thay thế trong AI Studio.
- Triển khai khóa mới vào ứng dụng và xác nhận khóa hoạt động.
- Vô hiệu hóa khóa cũ trong bảng điều khiển Cloud. Đừng xóa khóa cũ trước khi khóa mới được đưa vào sử dụng, nếu không ứng dụng sẽ bị gián đoạn.
- Kiểm tra thanh toán và mức sử dụng API trong bảng điều khiển Cloud để phát hiện lưu lượng không rõ nguồn gốc. Trang Mức sử dụng của AI Studio gom lưu lượng không thể đối chiếu với một khóa có tên vào nhóm “(khóa không xác định)”.
Khắc phục sự cố: vì sao khóa Gemini API không hoạt động
| Hiện tượng | Nguyên nhân có thể xảy ra | Cách khắc phục |
|---|---|---|
403 hoặc “Khóa API không hợp lệ” khi dùng khóa cũ |
Khóa tiêu chuẩn không có hạn chế, hiện đã bị từ chối | Chỉ giới hạn khóa cho Gemini API hoặc tạo khóa auth mới |
| Khóa hiển thị Bị chặn trong AI Studio | Khóa không có hạn chế và lâu không sử dụng, bị chặn kể từ ngày 7 tháng 5 năm 2026 | Tạo khóa mới và cập nhật ứng dụng |
| Mã của bạn bỏ qua khóa mới | GOOGLE_API_KEY cũng được đặt và được ưu tiên |
Gỡ biến đó hoặc đặt giá trị của biến thành khóa mới |
| Công cụ bên thứ ba báo sai định dạng khóa | Công cụ yêu cầu tiền tố cũ | Cập nhật công cụ hoặc định tuyến qua cổng tương thích với OpenAI |
| “Bạn không có quyền tạo khóa” | Thiếu quyền IAM trong dự án Cloud | Nhờ quản trị viên hỗ trợ hoặc sử dụng dự án bên ngoài tổ chức |
429 RESOURCE_EXHAUSTED |
Giới hạn RPM, TPM, RPD hoặc giới hạn theo mức chi tiêu | Thử lại với thời gian chờ tăng dần, giảm kích thước yêu cầu hoặc nâng cấp sử dụng |
| Không tìm thấy mô hình hoặc mô hình không khả dụng | Mô hình không thuộc gói miễn phí (ví dụ: Gemini 4 Argon) | Liên kết thanh toán hoặc chọn mô hình có gói miễn phí |
Để tìm hiểu các cách xử lý lỗi trên nhiều nhà cung cấp, hãy xem hệ thống phân loại lỗi cổng LLM của chúng tôi.
Danh sách kiểm tra khóa Gemini API trước khi đưa vào production
Một khóa chạy được trong notebook chưa có nghĩa là đã sẵn sàng phục vụ người dùng. Trước khi ra mắt:
- Giữ khóa trên máy chủ. Tuyệt đối không đóng gói khóa trong ứng dụng web hoặc di động; Google cho biết khóa trong mã phía máy khách có thể bị trích xuất. Đặt một proxy backend nhỏ giữa máy khách và Gemini.
- Mỗi môi trường và mỗi ứng dụng dùng một khóa riêng. Tách riêng khóa cho môi trường phát triển, staging và production để có thể thu hồi một khóa mà không làm gián đoạn các môi trường còn lại. Đặt tên khóa rõ ràng.
- Lưu khóa trong trình quản lý bí mật. Google khuyến nghị dùng Secret Manager cho môi trường production. Nạp khóa khi ứng dụng chạy.
- Giới hạn theo API và theo IP nếu có thể. Khóa auth mặc định chỉ dùng cho Gemini; hãy thêm hạn chế theo IP cho các backend cố định.
- Giới hạn quyền tài khoản dịch vụ ở mức tối thiểu. Đừng cấp cho tài khoản dịch vụ đã liên kết những vai trò có quyền rộng mà tài khoản không cần đến.
- Bật cảnh báo thanh toán trong bảng điều khiển Google Cloud để bạn nhận được thông báo khi chi phí tăng đột biến trước khi hóa đơn đến.
- Cố định ID mô hình. Dùng ID chính xác như
gemini-3.8-flashtrong cấu hình và lên kế hoạch cho các thay đổi giá vào ngày 1 tháng 12 năm 2026 và ngày 1 tháng 1 năm 2027. - Dùng gói trả phí cho dữ liệu người dùng. Nội dung của gói miễn phí có thể được dùng để cải thiện các sản phẩm của Google.
- Lên kế hoạch xử lý giới hạn tốc độ. Thêm cơ chế chờ tăng theo cấp số nhân khi gặp
429và quyết định cách xử lý khi chạm giới hạn: đưa vào hàng đợi, chuyển xuống mô hình nhỏ hơn hoặc chuyển sang phương án dự phòng. - Quét kho mã nguồn để tìm khóa bị lộ. Bật tính năng quét bí mật của GitHub và bảo vệ khi đẩy mã.
- Luân chuyển khóa định kỳ. Tạo khóa mới, triển khai, xác minh rồi vô hiệu hóa khóa cũ.
Để rà soát kỹ hơn, hãy sử dụng danh sách kiểm tra mức độ sẵn sàng đưa Gemini API vào production và hướng dẫn quản lý khóa API an toàn của chúng tôi.
Khi nào dùng một khóa Flatkey đơn giản hơn khóa Gemini
Nếu ứng dụng của bạn còn gọi Claude, GPT, DeepSeek hoặc Qwen, việc quản lý khóa, tài khoản thanh toán và cấp giới hạn tốc độ riêng cho từng nhà cung cấp sẽ làm tăng khối lượng công việc. Flatkey cung cấp một khóa và URL cơ sở tương thích với OpenAI (https://router.flatkey.ai/v1) để dùng Gemini cùng các mô hình khác, kèm nhật ký sử dụng theo từng khóa (tài liệu Flatkey). Cần đánh giá thẳng thắn sự đánh đổi về giá vì mức chênh lệch thay đổi theo mô hình. Vào ngày 27 tháng 10 năm 2026, các trang mô hình của Flatkey niêm yết:
| Mô hình | Giá niêm yết của Google (Tiêu chuẩn) | Flatkey |
|---|---|---|
| Gemini 4 Argon | $2.00 / $10.00 | $1.60 / $8.00 |
| Gemini 3.5 Flash-Lite | $0.30 / $2.50 | $0.24 / $2.00 |
| Gemini 3.8 Flash | $0.75 / $3.75 (khuyến mãi đến hết ngày 31 tháng 12 năm 2026) | $1.20 / $6.00 |
Với Gemini 3.8 Flash, giá khuyến mãi của Google thấp hơn Flatkey đến hết ngày 31 tháng 12 năm 2026, nên ứng dụng chỉ dùng Flash sẽ tiết kiệm hơn khi gọi trực tiếp Google cho đến thời điểm đó. Flatkey phù hợp hơn với Argon, Flash-Lite hoặc ứng dụng kết hợp nhiều nhà cung cấp.
from openai import OpenAI
import os
client = OpenAI(api_key=os.environ["FLATKEY_API_KEY"], base_url="https://router.flatkey.ai/v1")
resp = client.chat.completions.create(
model="gemini-4-argon",
messages=[{"role": "user", "content": "Summarize this stack trace in one line."}],
)
print(resp.choices[0].message.content)
Câu hỏi thường gặp
Làm thế nào để lấy khóa Google Gemini API?
Đăng nhập tại aistudio.google.com/apikey, chấp nhận điều khoản, chọn hoặc nhập một dự án Google Cloud rồi nhấp vào Tạo khóa API. Người dùng mới sẽ tự động được tạo một dự án mặc định cùng một khóa. Khóa hiển thị trên trang API Keys của AI Studio.
Khóa Gemini API có miễn phí không?
Có. Việc tạo khóa không mất phí, và các mô hình như Gemini 3.8 Flash và Gemini 3.5 Flash-Lite có gói miễn phí với giới hạn tốc độ. Nội dung của gói miễn phí có thể được dùng để cải thiện các sản phẩm của Google, còn Gemini 4 Argon không có gói miễn phí.
Làm thế nào để sử dụng Gemini API miễn phí?
Tạo khóa mà không liên kết thanh toán, gọi mô hình có gói miễn phí như gemini-3.8-flash và tuân thủ các giới hạn hiển thị trong AI Studio. Giới hạn áp dụng theo dự án, nên thêm khóa trong cùng một dự án không làm tăng hạn ngạch.
Tôi có thể tìm khóa Google API của mình ở đâu?
Trong Google AI Studio, tại Bảng điều khiển → API Keys. Các khóa bị giới hạn cho những Google API ngoài Gemini chỉ được liệt kê trên trang thông tin xác thực của bảng điều khiển Google Cloud.
Người khác có thể làm gì với khóa API của tôi?
Họ có thể gửi yêu cầu được tính phí vào dự án của bạn, dùng hết hạn ngạch và, với khóa ủy quyền, hoạt động dưới danh tính tài khoản dịch vụ đã liên kết. Nếu nghi ngờ khóa bị lộ, hãy thay khóa, triển khai khóa mới, vô hiệu hóa khóa cũ và rà soát mức sử dụng.
Tại sao khóa Gemini API cũ của tôi ngừng hoạt động?
Từ năm 2026, Gemini API từ chối khóa tiêu chuẩn không có hạn chế, và kể từ ngày 7 tháng 5 năm 2026, API chặn các khóa không có hạn chế đã lâu không được sử dụng. Hãy giới hạn khóa cho Gemini API hoặc tạo khóa ủy quyền mới.
Tôi có thể dùng khóa Gemini API với OpenAI SDK không?
Có. Đặt URL cơ sở thành https://generativelanguage.googleapis.com/v1beta/openai/ và truyền khóa Gemini làm khóa API.
Kết luận
Lấy khóa Gemini trong AI Studio mất hai phút; bảo mật khóa cần thêm một chút công sức. Hãy dùng khóa ủy quyền, lưu trên máy chủ trong trình quản lý bí mật, áp dụng hạn chế, đặt cảnh báo thanh toán, dùng gói trả phí cho dữ liệu người dùng thực và theo dõi các thay đổi giá đã lên lịch. Nếu bạn sử dụng nhiều nhà cung cấp, một khóa cổng chung có thể thay thế cả loạt khóa riêng của từng nhà cung cấp. So sánh các mô hình trong danh mục mô hình Flatkey và xem hướng dẫn định tuyến giữa Gemini và Claude để biết khi nào nên gửi lưu lượng đến từng bên.
