Gemini API và Google AI Studio: bắt đầu từ đâu

Gemini API là gì và nên bắt đầu từ đâu? Gemini API là giao diện lập trình để phần mềm của bạn gửi yêu cầu tới các model Gemini của Google, còn Google AI Studio là trang web để thử prompt, tạo khoá API, xem hạn mức và bật thanh toán cho chính Gemini API đó. Phần giới thiệu chung về Gemini nằm ở bài Gemini là gì?. Bài không hứa gói miễn phí đủ cho sản phẩm thật, không bảo đảm giá giữ nguyên, không phải tư vấn pháp lý; mọi con số đọc trên trang chính thức ngày 04/11/2026, tính bằng USD, chưa gồm thuế, có thể khác khi thanh toán từ Việt Nam. Bài đi qua lấy khoá, gói, rate limit, giá, dữ liệu, endpoint tương thích OpenAI và rủi ro lộ khoá.

Từ AI Studio tới cuộc gọi API đầu tiên: khoá, gói, hạn mức và an toàn. Sơ đồ: OPCAIOS.

Google AI Studio và Gemini API khác nhau thế nào?

Google AI Studio là bảng điều khiển trên web, còn Gemini API là cổng để mã nguồn gọi model. Theo tài liệu Gemini API trên ai.google.dev (đọc ngày 04/11/2026), mỗi khoá Gemini API gắn với một project Google Cloud, nơi quản lý thanh toán, người cộng tác và quyền; người dùng mới chấp nhận điều khoản trong AI Studio sẽ được tạo sẵn một project mặc định và một khoá API. Ứng dụng hay công cụ như n8n gọi Gemini API qua HTTP. Điều khoản bổ sung của Gemini API (hiệu lực từ 23/03/2026) ghi AI Studio và Gemini API dành cho nhà phát triển dùng vì mục đích công việc, không dành cho người tiêu dùng, và người dùng phải từ 18 tuổi. Nếu khái niệm API còn mới, xem API là gì.

Lấy khoá Gemini API như thế nào?

Lấy khoá Gemini API làm trong AI Studio; danh sách vùng khả dụng đọc ngày 04/11/2026 có Việt Nam. Các bước theo tài liệu:

1. Đăng nhập Google AI Studio bằng tài khoản Google, chấp nhận điều khoản.
2. Mở trang API keys; người mới đã có sẵn project mặc định và một khoá.
3. Tạo project riêng cho từng ứng dụng nếu muốn tách chi phí.
4. Đặt khoá vào biến môi trường GEMINI_API_KEY (hoặc GOOGLE_API_KEY, biến này được ưu tiên nếu đặt cả hai), không dán vào mã.

Tài liệu cũng ghi từ ngày 28/05/2026, khoá mới tạo trong AI Studio mặc định là "authorization key": gắn với một service account, giới hạn sẵn cho Gemini API, có cơ chế chặn nhanh khoá bị lộ. Gemini API từ chối khoá "standard" không có giới hạn; khoá standard đã được giới hạn vẫn chạy.

Gói miễn phí và gói trả phí của Gemini API khác gì nhau?

Gói Free và gói Paid của Gemini API khác nhau ở model, hạn mức, tính năng và cách Google dùng dữ liệu. Theo trang Pricing (đọc 04/11/2026):

Tiêu chí	Free	Paid
Model	Một số model	Có các model mạnh nhất
Token	Miễn phí	Trả theo triệu token
Tính năng	AI Studio	Context caching, Batch API giảm 50%
Dữ liệu	Được dùng cải thiện sản phẩm	Không dùng cải thiện sản phẩm

Theo trang Billing, lên Paid cần liên kết tài khoản thanh toán và nạp trước tối thiểu 5 USD vào số dư Prepay; khi số dư về 0, các khoá trong project bị từ chối cho tới khi nạp thêm. So sánh gói cho người dùng ứng dụng Gemini nằm ở bài Gemini miễn phí và trả phí.

Rate limit của Gemini API tính ra sao?

Rate limit của Gemini API là số yêu cầu và số token được gửi trong một khoảng thời gian, tính theo project chứ không theo khoá. Theo trang Rate limits (đọc 04/11/2026), có ba thước đo chính: yêu cầu mỗi phút (RPM), token đầu vào mỗi phút (TPM) và yêu cầu mỗi ngày (RPD); vượt mức nào cũng bị lỗi, RPD đặt lại lúc nửa đêm giờ Thái Bình Dương. Trang này không đăng bảng số cố định cho từng model mà hướng người dùng xem hạn mức đang áp dụng trong AI Studio, kèm lưu ý hạn mức không được bảo đảm. Bảng tier đọc được:

Tier	Điều kiện	Trần chi tiêu tier	Trần mỗi 10 phút
Free	Project đang hoạt động	Không áp dụng	Không áp dụng
Tier 1	Liên kết tài khoản thanh toán	250 USD	10 USD
Tier 2	Đã trả 100 USD, qua 3 ngày	2.000 USD	200 USD
Tier 3	Đã trả 1.000 USD, qua 30 ngày	20.000 đến hơn 100.000 USD	200 USD

Nên tự đặt giới hạn chi tiêu hằng tháng cho project trong AI Studio ngay khi bật thanh toán.

Giá Gemini API theo model hôm nay là bao nhiêu?

Giá Gemini API tính theo mỗi triệu token, khác nhau theo model, và vài model đã công bố lịch tăng giá. Bảng dưới là giá Standard của một số model văn bản trên trang Pricing ngày 04/11/2026; Google ghi thay đổi giá thường có hiệu lực 30 ngày sau khi đăng.

Model	Free	Đầu vào (USD/1 triệu token)	Đầu ra (gồm token suy nghĩ)
Gemini 4 Argon	Không	2,00; từ 01/12/2026 là 4,00	10,00; từ 01/12/2026 là 20,00
Gemini 3.8 Flash	Có	0,75; từ 01/01/2027 là 1,50	3,75; từ 01/01/2027 là 7,50
Gemini 3.1 Pro Preview	Không	2,00 (prompt tới 200k token)	12,00
Gemini 3.5 Flash-Lite	Có	0,30	2,50
Gemini 3.1 Flash-Lite	Có	0,25 (văn bản, ảnh, video)	1,50

Lưu ý: token suy nghĩ tính vào đầu ra; Grounding with Google Search có 5.000 yêu cầu miễn phí mỗi tháng dùng chung cho model Gemini 3 trở lên, sau đó 14 USD mỗi 1.000 yêu cầu. Trang Pricing cũng ghi Gemini 2.5 Flash và 2.5 Pro đã ngừng chọn trong AI Studio; từ 01/12/2026 yêu cầu tới gemini-2.5-flash tự chuyển sang Gemini 3.5 Flash-Lite, tới gemini-2.5-pro tự chuyển sang Gemini 3.8 Flash và tính theo giá model mới.

Dữ liệu gói miễn phí có được dùng để cải thiện sản phẩm không?

Có. Điều khoản bổ sung của Gemini API (đọc ngày 04/11/2026) xếp AI Studio dùng miễn phí và phần hạn mức không trả tiền của Gemini API vào nhóm "Unpaid Services". Với nhóm này, Google dùng nội dung gửi vào và câu trả lời để cung cấp, cải thiện, phát triển sản phẩm và công nghệ học máy; người đánh giá có thể đọc đầu vào, đầu ra sau khi dữ liệu được tách khỏi tài khoản và project. Điều khoản dặn không gửi thông tin nhạy cảm, bí mật hoặc cá nhân vào dịch vụ không trả phí. Với "Paid Services" (project có tài khoản thanh toán đang hoạt động), Google không dùng prompt và câu trả lời để cải thiện sản phẩm, chỉ lưu nhật ký có thời hạn để phát hiện vi phạm chính sách. AI Studio được tính là dịch vụ trả phí kể cả khi không tốn tiền, nếu tài khoản có quyền vào project gắn thanh toán đang hoạt động. Đây là tóm tắt, không phải tư vấn pháp lý. Xem thêm 5 quy tắc bảo mật dữ liệu kinh doanh khi dùng AI.

Gọi Gemini API lần đầu bằng lệnh nào?

Lệnh gọi tối thiểu theo trang Quickstart (đọc 04/11/2026) là một yêu cầu POST tới endpoint interactions, truyền khoá qua header. Đoạn dưới chép từ tài liệu, cần biến GEMINI_API_KEY đã có khoá:

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Api-Revision: 2026-05-20" \
  -d '{
    "model": "gemini-3.8-flash",
    "input": "Explain how AI works in a few words"
  }'

Chúng tôi không chạy lệnh này khi viết bài; tên model và giá trị Api-Revision có thể đổi, hãy lấy bản mới nhất trên trang Quickstart.

Endpoint tương thích OpenAI của Gemini API dùng thế nào?

Endpoint tương thích OpenAI cho phép mã đang dùng thư viện OpenAI gọi model Gemini bằng cách đổi ba thứ: khoá API, base URL và tên model. Theo trang OpenAI compatibility (đọc 04/11/2026), base URL là https://generativelanguage.googleapis.com/v1beta/openai/, khoá truyền qua header Authorization: Bearer, đường dẫn chat là chat/completions, và tài liệu có ví dụ cho Python, JavaScript và REST với model gemini-3.8-flash. Google khuyên nếu chưa dùng thư viện OpenAI thì gọi Gemini API trực tiếp.

Lộ khoá Gemini API thì rủi ro gì và xử lý ra sao?

Lộ khoá Gemini API nghĩa là người khác có thể tiêu hạn mức của project, phát sinh hoá đơn và truy cập tài nguyên riêng; tài liệu Google khuyên đối xử với khoá như mật khẩu. Các quy tắc trên trang API keys (đọc 04/11/2026):

1. Không đưa khoá vào Git.
2. Không nhúng khoá vào ứng dụng web hoặc di động phía người dùng; gọi API qua máy chủ trung gian.
3. Đọc khoá từ biến môi trường; môi trường thật dùng kho bí mật như Google Cloud Secret Manager.
4. Bật cảnh báo thanh toán và đặt giới hạn chi tiêu cho project.
5. Giới hạn khoá chỉ cho Gemini API, và theo IP hoặc ứng dụng nếu được.

Khi nghi lộ khoá: tạo khoá mới, triển khai lại ứng dụng với khoá mới, vô hiệu hoá khoá cũ khi khoá mới chạy ổn, rồi kiểm tra nhật ký thanh toán và lượng dùng. Xem thêm bảo mật khi dùng AI viết code.

Kinh nghiệm của OPCAIOS

Trang quản trị opcaios.org có tuỳ chọn nhà cung cấp "Google Gemini" cho các tính năng viết bằng AI, đi qua endpoint tương thích OpenAI mô tả ở trên; đó là tuỳ chọn có sẵn, chúng tôi không khẳng định đang dùng hằng ngày. Trong lần chạy thử ngày 03/11/2026, một công cụ dựng video ngắn nội bộ dùng một model tạo ảnh Gemini Flash Image để sinh ảnh minh hoạ; kết quả còn lỗi (ảnh lặp, một ảnh sai nhân vật), nên chưa dùng thật. Chúng tôi chưa đo chi phí hay độ ổn định của Gemini API lâu dài. Bài học duy nhất dám nói: tách khoá theo từng ứng dụng, để khoá trên máy chủ, không bao giờ trong mã phía trình duyệt.

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

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

Có gói Free với token miễn phí cho một số model, theo trang Pricing đọc ngày 04/11/2026. Gemini 3.8 Flash và Gemini 3.5 Flash-Lite có cột Free ghi miễn phí, còn Gemini 4 Argon và Gemini 3.1 Pro Preview không có ở gói Free. Gói Free bị giới hạn hạn mức và dữ liệu gửi vào có thể được dùng cải thiện sản phẩm của Google, nên chỉ hợp để thử với dữ liệu không nhạy cảm.

Rate limit tính theo khoá hay theo project?

Theo trang Rate limits đọc ngày 04/11/2026, rate limit áp dụng theo project, không theo khoá API, nên tạo thêm khoá trong cùng project không làm tăng hạn mức. Muốn tách hạn mức, tạo project riêng cho mỗi ứng dụng. Hạn mức cụ thể của bạn xem ở trang Rate limit trong Google AI Studio, vì Google không đăng bảng số cố định và ghi rõ hạn mức không được bảo đảm.

Gói trả phí của Gemini API bắt đầu từ bao nhiêu tiền?

Theo trang Billing đọc ngày 04/11/2026, lên gói trả phí cần liên kết tài khoản thanh toán và nạp trước tối thiểu 5 USD (hoặc tương đương) vào số dư Prepay, sau đó trả theo lượng token thực dùng tuỳ model. Tier 1 có trần chi tiêu 250 USD; lên Tier 2 cần đã trả 100 USD và qua 3 ngày. Số tiền thực trả từ Việt Nam có thể khác do thuế, tỉ giá; chưa kiểm chứng.

Có dùng được thư viện OpenAI để gọi Gemini không?

Có. Trang OpenAI compatibility đọc ngày 04/11/2026 cho thấy thư viện OpenAI cho Python, JavaScript và REST gọi được model Gemini khi đổi khoá sang khoá Gemini, đổi base URL sang endpoint v1beta/openai/ của Google và đổi tên model, ví dụ gemini-3.8-flash. Google vẫn khuyên gọi Gemini API trực tiếp nếu bạn chưa dùng thư viện OpenAI, vì một số tính năng riêng chỉ có ở API gốc.

Muốn đưa Gemini API vào quy trình kinh doanh thì bắt đầu từ đâu?

Chọn một việc nhỏ, lặp lại, dữ liệu không nhạy cảm, như tóm tắt bài viết hay phân loại email. Thử trên AI Studio trước, rồi gọi API qua một công cụ tự động hoá, đặt giới hạn chi tiêu và đo kết quả vài tuần trước khi mở rộng. Xem thêm hệ thống AI vận hành một mình. Nếu muốn được hướng dẫn có lộ trình, xem khoá đào tạo ứng dụng AI của OPCAIOS.

Nguồn: tài liệu Gemini API (địa chỉ ai.google.dev nay chuyển hướng sang aistudio.google.com/docs) gồm (Pricing, Rate limits, API keys, Billing, Quickstart, OpenAI compatibility, Available regions) và Gemini API Additional Terms of Service hiệu lực 23/03/2026 (đọc ngày 04/11/2026); điều chưa kiểm chứng: phản hồi của lệnh mẫu (không chạy), hạn mức Free cụ thể từng model (chỉ hiện trong AI Studio), số tiền thực trả từ Việt Nam; giá và tên model có thể đổi sau ngày đọc. Kinh nghiệm là của OPCAIOS.