Kiến thức

Gemini API key: cách lấy miễn phí ở Google AI Studio từng bước 2026

Gemini API key là mã để ứng dụng, chatbot hay công cụ lập trình của bạn gọi được các mô hình Gemini của Google. Bài này hướng dẫn lấy key miễn phí trong vài phút, giải thích gói miễn phí được gì và mất gì, khi nào phải trả tiền, giá từng mô hình, và cách dùng Gemini khi bạn không có thẻ tín dụng.

Tóm tắt: Vào aistudio.google.com/apikey, đăng nhập tài khoản Google, đồng ý điều khoản: Google AI Studio tự tạo sẵn một project và một API key (nếu bạn chưa từng dùng Google Cloud). Gói miễn phí dùng được Gemini 3.8 Flash và nhiều mô hình Flash khác, có giới hạn số lượt, và nội dung bạn gửi có thể được Google dùng để cải thiện sản phẩm. Gemini 4 Argon và Gemini 3.1 Pro không có trong gói miễn phí. Muốn trả phí phải liên kết tài khoản thanh toán Google Cloud (ở Việt Nam là thẻ tín dụng) và thường phải nạp trước tối thiểu 5 USD.

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

Có. Tạo key không mất tiền, và gói miễn phí cho gọi Gemini 3.8 Flash cùng nhiều mô hình Flash khác mà không trả đồng nào, trong giới hạn số lượt Google đặt cho từng project. Đổi lại, nội dung bạn gửi có thể được Google dùng để cải thiện sản phẩm, và các mô hình mạnh nhất (Gemini 4 Argon, Gemini 3.1 Pro) không có trong gói miễn phí. Chi tiết ở các mục dưới.

Cần gì để lấy Gemini API key?

  • Một tài khoản Google.
  • Đủ 18 tuổi. Điều khoản Gemini API ghi rõ yêu cầu này và nói API dành cho mục đích công việc, kinh doanh (điều khoản Gemini API).
  • Ở khu vực được hỗ trợ: Việt Nam có trong danh sách khu vực (đọc ngày 17/10/2026).

Lấy key miễn phí không cần thẻ. Chỉ khi bật gói trả phí mới phải thêm phương thức thanh toán.

Các bước tạo Gemini API key

  1. Mở aistudio.google.com/apikey và đăng nhập tài khoản Google.
  2. Đọc và đồng ý điều khoản. Theo tài liệu của Google, với người dùng mới, sau bước này AI Studio tự tạo một project Google Cloud và một API key mặc định.
  3. Vào trang API Keys để xem và sao chép key. Nếu bạn đã có project Google Cloud riêng, dùng nút Import projects để đưa project vào rồi tạo key trong đó.
  4. Key tạo từ ngày 28/05/2026 đã được giới hạn sẵn cho Gemini API. Nếu bạn có key cũ ghi là không giới hạn (Unrestricted), hãy bấm Add restrictions → Restrict to Gemini API only, vì Gemini API từ chối key thường không giới hạn.

Nếu gặp thông báo "You do not have permission to create a key in this project", tài khoản của bạn thiếu quyền tạo key trong project đó; hãy dùng project của chính bạn hoặc nhờ người quản trị cấp quyền.

Thử key bằng một lệnh

Đặt key vào biến môi trường GEMINI_API_KEY rồi chạy lệnh mẫu trong hướng dẫn nhanh của Google (macOS, Linux):

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model": "gemini-3.8-flash", "input": "Giải thích AI là gì trong một câu"}'

Công cụ chỉ hỗ trợ kiểu OpenAI vẫn dùng được Gemini: Google có địa chỉ tương thích https://generativelanguage.googleapis.com/v1beta/openai/, gửi key ở header Authorization: Bearer (tài liệu tương thích OpenAI).

Gói miễn phí được gì, mất gì?

Theo trang giá Gemini API (đọc ngày 17/10/2026):

  • Miễn phí token vào, ra với các mô hình như Gemini 3.8 Flash, 3.6 Flash, 3.5 Flash-Lite, 3.1 Flash-Lite, dòng 2.5 Pro, 2.5 Flash, 2.5 Flash-Lite.
  • Không miễn phí: Gemini 4 Argon, Gemini 3.1 Pro (bản preview), các mô hình tạo ảnh, video.
  • Có giới hạn số lượt. Google không còn đăng bảng con số chung mà cho xem trực tiếp trong AI Studio ở trang Rate limit. Giới hạn tính theo project, không theo key, nên tạo thêm key trong cùng project không tăng được lượt. Giới hạn theo ngày đặt lại lúc nửa đêm giờ Thái Bình Dương (khoảng 14–15 giờ chiều giờ Việt Nam).
  • Dữ liệu: ở gói miễn phí, nội dung gửi lên được dùng để cải thiện sản phẩm và người của Google có thể đọc, gắn nhãn. Google dặn không gửi thông tin nhạy cảm, bí mật hay thông tin cá nhân qua dịch vụ miễn phí. Gói trả phí thì không dùng dữ liệu theo cách này.

Gói miễn phí hợp để học, thử nghiệm, làm dự án cá nhân. Nếu bạn xử lý dữ liệu khách hàng, tài liệu công ty, hãy dùng gói trả phí hoặc một dịch vụ có điều khoản dữ liệu phù hợp.

Khi nào phải trả tiền và trả thế nào?

Bạn cần gói trả phí khi muốn dùng Gemini 4 Argon, Gemini 3.1 Pro, cần nhiều lượt hơn giới hạn miễn phí, hoặc không muốn dữ liệu bị dùng để cải thiện sản phẩm.

  1. Trong AI Studio, bấm Set up billing ở trang API Keys hoặc Projects (hướng dẫn thanh toán).
  2. Chọn quốc gia, điền thông tin liên hệ và phương thức thanh toán. Theo bảng tiền tệ theo quốc gia của Google Cloud, tài khoản ở Việt Nam được tính bằng VNĐ và chỉ ghi phương thức thẻ tín dụng (không có tài khoản ngân hàng; thẻ ghi nợ chưa chắc được nhận).
  3. Nạp trước (thường tối thiểu 5 USD). Với hình thức trả trước, Gemini API chỉ phục vụ khi số dư còn dương; số dư về 0 thì mọi key trong các project liên kết cùng ngừng chạy và báo lỗi 402. Tiền nạp chưa dùng hết hạn sau 12 tháng và không hoàn lại. Hạn mức chi tiêu tăng dần theo bậc (Tier 1, 2, 3) khi bạn đã trả nhiều hơn và dùng lâu hơn.

Giá trả phí các mô hình chính (USD mỗi 1 triệu token, mức Standard):

Mô hìnhĐầu vàoĐầu raGhi chú
Gemini 4 Argon2 USD10 USDTừ 01/12/2026: 4 USD vào, 20 USD ra
Gemini 3.1 Pro (preview)2 USD (≤200k) · 4 USD (>200k)12 USD · 18 USDKhông có gói miễn phí
Gemini 3.8 Flash0,75 USD3,75 USDTừ 01/01/2027: 1,50 USD vào, 7,50 USD ra
Gemini 3.5 Flash-Lite0,30 USD2,50 USD
Gemini 2.5 Flash-Lite0,10 USD0,40 USD

Giá theo trang giá Gemini API ngày 17/10/2026, chưa gồm thuế; xử lý theo lô (Batch) rẻ hơn khoảng một nửa. Token là gì và cách tự tính tiền có trong bài token AI là gì.

Không có thẻ tín dụng thì dùng Gemini thế nào?

Nếu gói miễn phí không đủ mà bạn không có thẻ tín dụng, có thể dùng Gemini qua một cổng API thanh toán bằng VNĐ. Tại APIZ hiện mở bán Gemini 3.8 Flash; Gemini 4 Argon và Gemini 3.1 Pro chưa mở bán. APIZ là một cổng như vậy: một tài khoản gọi được Gemini, Claude, GPT, Grok, DeepSeek; giá niêm yết bằng VNĐ, trả theo token dùng thật, nạp bằng chuyển khoản VietQR từ 26.000 ₫. APIZ là cổng API trung gian độc lập, không phải đối tác hay đại lý của Google, OpenAI hay Anthropic. Key APIZ khác key Google và không dùng được trong AI Studio; bạn dùng nó trong ứng dụng, công cụ của mình ở chế độ tương thích OpenAI, với địa chỉ https://api.apiz.vn/v1.

Giá Gemini 3.8 Flash tại APIZ ngày 17/10/2026 (mỗi 1 triệu token): đầu vào 1.350 ₫, đầu ra 6.700 ₫, đọc đệm 135 ₫. Giá mới nhất xem ở bảng giá. Tốc độ và giới hạn ngữ cảnh có thể khác so với gọi thẳng Google, nên hãy nạp ít và thử trước.

Lỗi hay gặp khi dùng Gemini API key

  • Lỗi 429 (RESOURCE_EXHAUSTED): vượt giới hạn số lượt hoặc hạn mức chi tiêu. Chờ một lúc rồi thử lại, giảm số lượt gọi, hoặc xem giới hạn của project trong AI Studio.
  • Lỗi 402 (Payment Required): số dư trả trước đã về 0. Nạp thêm tiền trong mục thanh toán.
  • Key bị từ chối: thường do key cũ không giới hạn; thêm giới hạn "Restrict to Gemini API only" như ở bước 4.
  • Không tạo được key ("You do not have permission…"): tài khoản thiếu quyền trong project đó.

Giữ API key an toàn

  • Coi key như mật khẩu. Ai có key đều dùng được và bạn chịu tiền.
  • Không đưa key lên GitHub hay bất kỳ kho mã nào; để key trong biến môi trường (GEMINI_API_KEY) hoặc kho bí mật.
  • Không gắn key thẳng vào ứng dụng web hay di động; gọi qua máy chủ của bạn.
  • Giới hạn key chỉ cho Gemini API, và với gói trả phí, đặt ngân sách để lỡ lộ key cũng không mất nhiều tiền.

Bắt đầu với APIZ trong 3 bước

  1. Đăng ký tại api.apiz.vn.
  2. Nạp tiền bằng VietQR từ ứng dụng ngân hàng hoặc ví MoMo, tối thiểu 26.000 ₫. Xem Nạp tiền & chi phí.
  3. Tạo key, đặt hạn mức rồi kết nối công cụ theo hướng dẫn kết nối.

Số dư đã nạp không hoàn lại trừ các trường hợp ghi trong Chính sách hoàn tiền, vì vậy hãy bắt đầu bằng khoản nhỏ.

Tóm lại

Lấy Gemini API key rất nhanh: vào aistudio.google.com/apikey, đăng nhập, đồng ý điều khoản là có key. Gói miễn phí đủ để học và thử với Gemini 3.8 Flash và các bản Flash khác, nhưng có giới hạn lượt và dữ liệu có thể được Google dùng để cải thiện sản phẩm, nên đừng gửi thông tin nhạy cảm. Cần Gemini 4 Argon, 3.1 Pro hay nhiều lượt hơn thì bật trả phí bằng thẻ tín dụng và nạp trước; nếu không có thẻ mà chỉ cần Gemini 3.8 Flash với nhiều lượt hơn, có thể dùng qua cổng thanh toán VNĐ. Dù dùng cách nào, hãy giữ key như mật khẩu.