Bạn có thể dùng Gemini Decisions API miễn phí ngay hôm nay. Gói miễn phí của Google cho gemini-decision-1 không tính phí đầu vào, không tính token đầu ra, và cho phép 200 yêu cầu mỗi phút, 50.000 token mỗi phút và 10.000 yêu cầu mỗi ngày cho mỗi dự án. Bạn chỉ cần một API key từ AI Studio, không cần tài khoản thanh toán. Điểm cần lưu ý: ở gói miễn phí, Google có thể sử dụng nội dung của bạn để cải thiện sản phẩm của họ.
Bên dưới: những con số giới hạn này có ý nghĩa gì trong khối lượng công việc thực tế, phép tính token đằng sau giá trả phí 0,10 USD mỗi 1M token, các lộ trình miễn phí khác, và cách giữ cho các bài kiểm thử cùng CI không tiêu tốn hạn mức hàng ngày của bạn. Mọi hạn mức và mức giá đều được lấy từ các trang chính thức của Google vào ngày 12 tháng 11 năm 2026. API được phát hành dưới dạng v1beta, vì vậy hãy kiểm tra lại trước khi lập ngân sách. Để tìm hiểu về các loại câu hỏi (noul, choice, score), hãy xem hướng dẫn Decisions API của Google.
Gói miễn phí của Gemini Decisions API bao gồm những gì
Gói miễn phí của Gemini Decisions API là mức sử dụng không tính phí của Google Gemini Developer API áp dụng cho model gemini-decision-1. Nó cấp cho mỗi dự án Google Cloud khả năng xử lý đầu vào miễn phí, không tính phí đầu ra, và các giới hạn tốc độ cố định là 200 RPM, 50.000 TPM và 10.000 RPD, mà không cần thiết lập thanh toán.
Đây là nội dung trang giá và trang giới hạn tốc độ của Google, đặt cạnh nhau:
| Hạng mục | Gói miễn phí | Trả phí (Tier 1) |
|---|---|---|
| Giá đầu vào (văn bản, hình ảnh, video, âm thanh, PDF) | Miễn phí | 0,10 USD mỗi 1M token |
| Giá đầu ra | Không áp dụng (0 token đầu ra) | Không áp dụng (0 token đầu ra) |
| Yêu cầu mỗi phút | 200 | 1.500 |
| Token mỗi phút | 50.000 | 1.000.000 |
| Yêu cầu mỗi ngày | 10.000 | 50.000 |
| Nội dung được dùng để cải thiện sản phẩm Google | Có | Không |
| Context caching | Không khả dụng | Không khả dụng |
Ba chi tiết quan trọng hơn cả những con số tiêu đề:
- Hạn mức tính theo dự án, không phải theo API key. Tạo năm key trong một dự án cũng không cho bạn năm hạn mức.
- Hạn mức hàng ngày được đặt lại vào nửa đêm giờ Pacific. Một job chạy theo lô bắt đầu lúc 11 giờ đêm giờ Pacific sẽ nhận một giờ hạn mức của ngày hôm đó và 10.000 yêu cầu mới sau nửa đêm.
- Dữ liệu gói miễn phí có thể được Google sử dụng. Bảng giá đánh dấu "Used to improve our products" là Có ở gói miễn phí và Không ở gói trả phí. Đừng gửi thông tin cá nhân của khách hàng, hợp đồng hay hình ảnh y tế qua một key miễn phí.
Cách nhận API key Gemini Decisions miễn phí
Bạn có thể bắt đầu gọi miễn phí chỉ sau khoảng năm phút:
- Đăng nhập vào Google AI Studio và nhấn Create API key. Một dự án mới sẽ bắt đầu ở gói miễn phí.
- Cài đặt SDK 3.2 trở lên:
pip install -U google-genaihoặcnpm install @google/genai@latest. - Xuất key dưới dạng biến
GEMINI_API_KEYđể SDK tự nhận. - Gửi một yêu cầu với
http_options={"api_version": "v1beta"}và đọc khốiusagetrong phản hồi.
from google import genai
client = genai.Client(http_options={"api_version": "v1beta"})
result = client.decisions.create(
model="gemini-decision-1",
input="Order 8821 arrived with a cracked screen.",
questions={
"is_damaged": {"type": "noul", "instructions": "Did the item arrive damaged?"},
},
)
print(result.answers["is_damaged"].noul)
print(result.usage.total_input_tokens)
Con số usage.total_input_tokens chính là thứ cần ghi log. Ở gói miễn phí, nó là thứ làm hao mòn 50.000 TPM của bạn; ở gói trả phí, nó là thứ duy nhất bạn bị tính tiền.
Để biết các ưu đãi miễn phí khác của Google, hãy xem hướng dẫn gói miễn phí Gemini API và cách dùng Gemini miễn phí của chúng tôi.
Cách định giá của Gemini Decisions API hoạt động
Bạn chỉ trả tiền cho token đầu vào, và phần đầu vào dùng chung được tính một lần mỗi yêu cầu bất kể bạn hỏi bao nhiêu câu hỏi. Mỗi câu hỏi chỉ bổ sung token cho hướng dẫn và tiêu chí của riêng nó. Đầu ra luôn là 0 token, vì model trả về xác suất chứ không phải văn bản.
Vì vậy công thức cho một yêu cầu rất đơn giản:
input tokens = shared input + sum(each question's instructions + criteria)
paid cost = input tokens / 1,000,000 x $0.10
Phần thú vị là điều này ảnh hưởng thế nào đến gói miễn phí. Với văn bản, số lượng yêu cầu (200 RPM, 10.000 RPD) thường là ràng buộc chạm trước. Với hình ảnh, âm thanh hoặc tài liệu dài, giới hạn 50.000 TPM mới chạm trước.
Ví dụ tính chi tiết: gói miễn phí và gói trả phí
Các con số token cho câu hỏi bên dưới là ước lượng (khoảng 30 token cho mỗi câu hỏi ngắn). Số token của hình ảnh và âm thanh lấy từ bảng phân giải phương tiện của Google, liệt kê 280 token mỗi ảnh ở mức low, 1.120 ở mức high, và 25 token mỗi giây âm thanh cho các model Gemini hiện tại. Hãy chạy một yêu cầu thực tế và thay số của tôi bằng các giá trị usage của riêng bạn.
10.000 ảnh sản phẩm x 16 câu hỏi
Giả sử bạn kiểm tra ảnh giao hàng xem có hư hại, vị trí đặt hàng, độ đọc được của nhãn và 13 tiêu chí khác.
- Mỗi yêu cầu ở độ phân giải
low: 280 (ảnh) + 20 (ngữ cảnh văn bản) + 16 x 30 (câu hỏi) = 780 token - 10.000 ảnh: 10.000 x 780 = 7,8 triệu token
- Chi phí trả phí: 7,8 x 0,10 USD = 0,78 USD
- Ở độ phân giải
high: 1.120 + 20 + 480 = 1.620 token mỗi ảnh, 16,2 triệu token, 1,62 USD
Ở gói miễn phí, TPM quyết định tốc độ của bạn: 50.000 / 780 = khoảng 64 ảnh mỗi phút. Cả 10.000 ảnh hoàn tất trong khoảng 2 giờ 36 phút và dùng đúng một ngày hạn mức 10.000 yêu cầu. Ở mức high, khoảng 30 ảnh mỗi phút và mất 5,5 giờ.
Giờ là sai lầm cần tránh. Nếu bạn gửi 16 phép kiểm tra thành 16 yêu cầu riêng biệt, mỗi yêu cầu sẽ gửi lại ảnh: 16 x 300 = 4.800 token ảnh và ngữ cảnh, cộng thêm 480 token câu hỏi, khoảng 5.280 token mỗi ảnh. Đó là 52,8 triệu token (5,28 USD nếu trả phí) và 160.000 yêu cầu — tức 16 ngày hạn mức gói miễn phí. Hãy gộp các câu hỏi.
10.000 ticket hỗ trợ x 3 câu hỏi phân loại
- Mỗi yêu cầu: 250 (nội dung ticket) + 3 x 40 (câu hỏi kèm tiêu chí) = 370 token
- 10.000 ticket: 3,7 triệu token, 0,37 USD nếu trả phí
- Gói miễn phí: 50.000 / 370 = 135 yêu cầu mỗi phút, dưới mức 200 RPM. Một ngày hạn mức 10.000 yêu cầu đủ cho 10.000 ticket.
PDF dài
Cửa sổ ngữ cảnh là 262.144 token, nhưng TPM miễn phí chỉ là 50.000, nên một hợp đồng 120.000 token đã vượt quá toàn bộ ngân sách miễn phí của một phút. Tài liệu của Google không nói rõ gói miễn phí xử lý thế nào khi một yêu cầu duy nhất vượt giới hạn TPM, vì vậy hãy thử một yêu cầu trước. Tài liệu dài chính là lúc Tier 1 (1 triệu TPM) đáng giá tiền.
Các cách khác để dùng Gemini Decision 1 với chi phí 0 USD
| Lộ trình | Chi phí | Cần thẻ hoặc thanh toán? | Phù hợp với |
|---|---|---|---|
| Gói miễn phí Gemini API (key AI Studio) | 0 USD, 200 RPM / 50.000 TPM / 10.000 RPD | Không | Prototype, công cụ nội bộ, xử lý theo lô ban đêm dưới 10.000 yêu cầu |
| Decisions Playground trong AI Studio | 0 USD (mức không tính phí, theo bài đăng ra mắt của Google) | Không | Thử cách diễn đạt câu hỏi trước khi viết code |
OpenRouter (google/gemini-decision-1) |
0,10 USD mỗi 1M đầu vào, 0 USD đầu ra | Có, qua credit | Một key dùng cho nhiều nhà cung cấp; không miễn phí |
Trang model của OpenRouter, kiểm tra ngày 12 tháng 11 năm 2026, liệt kê một nhà cung cấp (Google AI Studio) ở mức 0,10 USD mỗi 1M token đầu vào, đầu ra miễn phí, và không có biến thể :free. Nó chạy trên endpoint Decisions của OpenRouter, nên các SDK chat completions sẽ không gọi được.
Cách ở lại trong giới hạn gói miễn phí
Những thói quen sau giúp prototype của bạn giữ mức 0 USD càng lâu càng tốt:
- Đặt mọi câu hỏi trong một yêu cầu. Đầu vào dùng chung chỉ bị tính một lần, và một lệnh gọi có thể chứa tới 1.000 câu hỏi.
- Hạ độ phân giải phương tiện. Mức
lowtốn một phần tư mứchighcho mỗi ảnh. - Chỉ gửi những trường mà câu hỏi cần. Google cho biết nội dung không liên quan làm giảm độ chính xác, và nó còn đốt TPM.
- Giới hạn theo TPM, không phải RPM. Điều phối các worker theo công thức 50.000 chia cho số token mỗi yêu cầu bạn đo được.
- Tự cache câu trả lời. API không có context caching và tính đầy đủ phần đầu vào lặp lại, vì vậy hãy băm đầu vào cùng câu hỏi và bỏ qua phần trùng lặp.
- Chạy các job lớn sau nửa đêm giờ Pacific để nhận trọn một ngày hạn mức.
- Giữ kiểm thử và CI khỏi API thật. Một bộ test gọi API mỗi lần push có thể tiêu tốn 10.000 yêu cầu trước giờ trưa. Hãy mock nó thay thế.
Để coding agent của bạn mock Decisions API với Apidog CLI
Unit test không cần model thật. Chúng cần đúng cấu trúc: một map answers, giá trị noul trong khoảng 0,01–0,99, một confidence, và usage.total_output_tokens: 0. Coding agent của bạn có thể dựng mock đó với Apidog CLI, để chỉ một bài smoke test chạm vào Google.
Thiết lập một lần:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
Sau đó đưa cho Claude Code, Codex hoặc Cursor một prompt:
In Apidog project <id>, add the Gemini Decisions endpoint POST /v1beta/decisions
with a request body of model, input and questions. Create mock expectations that
return a damaged answer (noul 0.97) and an undamaged one (noul 0.04), each with
usage.total_output_tokens = 0. Add a test case that asserts the answers map,
confidence between 0 and 1 and zero output tokens. Run it against the mock
environment, then once against the real API with my free-tier key.
Agent đọc schema của từng payload, xác thực nó, và chỉ sau đó mới viết:
apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file decisions-endpoint.json
apidog endpoint create --project <id> --file decisions-endpoint.json
apidog cli-schema get mock-create
apidog cli-schema validate mock-create --file mock-damaged.json
apidog mock create --project <id> --file mock-damaged.json
apidog cli-schema get test-case-create
apidog test-case create --project <id> --file decisions-case.json
apidog run --test-case <caseId> --project <id> -e <mockEnvId> -r cli,json
apidog run --test-case <caseId> --project <id> -e <freeTierEnvId> -r cli
Trong CI, chỉ chạy môi trường mock với -r junit (tệp pipeline trong hướng dẫn CI/CD Apidog CLI của chúng tôi); thiết lập agent nằm trong Apidog CLI trong Claude Code. Gói Free của Apidog hỗ trợ tới 4 người dùng, nên một nhóm nhỏ có thể dùng chung mock miễn phí. Bạn cũng đang cân nhắc phiên bản của OpenAI? Xem bài giải thích OpenAI Decisions API của chúng tôi.
Câu hỏi thường gặp
Gemini Decisions API có miễn phí không? Có, trong giới hạn nhất định. Gói miễn phí không tính phí đầu vào và đầu ra luôn là 0 token. Bạn được 200 yêu cầu mỗi phút, 50.000 token mỗi phút và 10.000 yêu cầu mỗi ngày cho mỗi dự án. Vượt quá đó, hãy thiết lập thanh toán và trả 0,10 USD mỗi 1M token đầu vào.
Tôi có cần thẻ tín dụng để dùng gói miễn phí Gemini Decisions API không? Không. Một API key từ Google AI Studio bắt đầu ở gói miễn phí. Trang giới hạn tốc độ của Google cho biết bạn chỉ chuyển sang gói trả phí sau khi thiết lập thanh toán trong AI Studio.
Google có huấn luyện trên dữ liệu Decisions API gói miễn phí của tôi không? Trang giá của Google đánh dấu "Used to improve our products" là Có cho gói miễn phí và Không cho gói trả phí. Hãy coi key gói miễn phí là không phù hợp với dữ liệu nhạy cảm.
Tại sao tôi gặp lỗi 429 dù dùng ít hơn nhiều so với 200 yêu cầu mỗi phút? Có lẽ bạn đã vượt 50.000 token mỗi phút. Đầu vào hình ảnh, âm thanh và PDF tốn nhiều token, nên TPM thường chạm giới hạn trước RPM. Hãy ghi log usage.total_input_tokens và điều phối yêu cầu theo công thức 50.000 chia cho con số đó.
Có model Gemini Decision 1 miễn phí trên OpenRouter không? Không, tính đến ngày 12 tháng 11 năm 2026. OpenRouter liệt kê google/gemini-decision-1 ở mức 0,10 USD mỗi 1M token đầu vào và 0 USD đầu ra, không có biến thể :free.
Tôi có thể dùng Batch API hoặc context caching để kéo dài gói miễn phí không? Không. Trang model liệt kê Batch API và caching là không được hỗ trợ ở mọi gói. Hãy gộp các câu hỏi vào một yêu cầu và cache câu trả lời ngay trong code của bạn.