Gemini 3.6 Flash là cấu hình đa phương thức chủ lực của Google dành cho lập trình, công việc kiến thức và thực thi theo tác tử. Mô hình phát triển từ Gemini 3.5 Flash, tập trung cải thiện hiệu năng đa phương thức và hiệu quả token. Mô hình nhận văn bản, hình ảnh, âm thanh, video và PDF, trả văn bản. Nhiệm vụ hữu ích có thể kết hợp mã, ảnh chụp màn hình và yêu cầu, hoặc so sánh biểu đồ hay bản vẽ trực quan với ràng buộc viết để tạo lời giải thích đã kiểm tra hoặc chỉnh sửa có mục tiêu.
Hướng dẫn nhà phát triển nhấn mạnh giảm bước suy luận, lượt và lời gọi công cụ không cần thiết trong công việc nhiều bước, đồng thời chỉnh sửa tập trung hơn. Với chẩn đoán, cung cấp lỗi quan sát được, nguồn liên quan và hành vi cần giữ nguyên. Với gỡ lỗi biểu đồ, yêu cầu mô hình xem vì sao biểu đồ hiển thị sai chuỗi dữ liệu, xác định phép biến đổi dữ liệu liên quan và đề xuất một chỉnh sửa trong khi giữ bố cục xung quanh. Sau đó có thể đối chiếu kết quả với dữ liệu đầu vào thực tế và hành vi biểu đồ yêu cầu.
Kiểm tra bằng chương trình ngay từ đầu là hành vi đặc trưng được mô tả cho 3.6. Nhà sản xuất cho biết mô hình thường xuyên hơn dùng mã chẩn đoán để xem vấn đề trước khi thay đổi. Cách này có thể hỗ trợ tìm hiểu phức tạp, nhưng hướng dẫn lưu ý có thể bổ sung bước khám phá cho công việc frontend thông thường. Nêu tác vụ cần điều tra, chỉnh sửa đơn giản hay so sánh thiết kế. Cung cấp thông tin làm rõ khác biệt đó và quy định hành động được phép cho công cụ của ứng dụng kết nối.
Suy luận không gian và đa phương thức cũng được nhấn mạnh: diễn giải biểu đồ, chuyển đổi bản vẽ trực quan và bố cục web nhiều thành phần. Cung cấp góc nhìn hoặc các trang liên quan, xác định nội dung cần diễn giải và yêu cầu bằng chứng đằng sau kết luận. Với tác vụ thiết kế, đưa hướng dẫn bố cục và phong cách cụ thể. Nhà sản xuất lưu ý trọng tâm mã hoạt động được và việc người đánh giá đôi khi thích phong cách hình ảnh của mô hình trước hơn, nên đề bài hình ảnh rõ ràng hữu ích. Đối chiếu kết quả với sơ đồ thực tế hoặc yêu cầu thiết kế.
Medium là mức suy luận mặc định được ghi trong tài liệu. Bảng mức suy luận riêng của mô hình Google liệt kê minimal, low, medium và high; hướng dẫn chuyển đổi 3.6 dùng medium hoặc high trong ví dụ nỗ lực. Trang cụ thể liệt kê gọi hàm, thực thi mã, tìm kiếm tệp, sử dụng kết quả tìm kiếm làm căn cứ, sử dụng thông tin Maps làm căn cứ, ngữ cảnh URL và đầu ra có cấu trúc, với Computer Use là khả năng xem trước. Định nghĩa rõ đầu vào hàm và kết quả bắt buộc. Hàm do mô hình chọn cần kết quả ứng dụng thực tế trước khi câu trả lời sau có thể dựa vào kết quả đó. Với phân tích có cấu trúc, định nghĩa lược đồ và bằng chứng nguồn cần cho từng phát hiện.
Hướng dẫn 3.6 thay đổi cách chuẩn bị so với các yêu cầu Gemini trước. Hướng dẫn ngừng khuyến nghị thiết lập lấy mẫu temperature, top-p và top-k, từ chối lượt model cuối được điền sẵn và khuyến nghị chỉ dẫn hệ thống hoặc đầu ra có cấu trúc để điều khiển câu trả lời. Quy tắc phản hồi hàm ghép phản hồi với lời gọi theo định danh và tên, còn nền tảng Gemini 3 giữ chữ ký suy luận khi dùng nhiều lượt. Phần tiếp nối thực tế cần mang theo lịch sử liên quan và kết quả công cụ không sửa đổi thay vì bắt chước tiền tố câu trả lời trước.
Thẻ gốc quy định ngữ cảnh đầu vào đến 1M và đầu ra văn bản 64K; bảng API cụ thể ghi 1,048,576 token đầu vào và 65,536 token đầu ra. Tính chỉ dẫn, lịch sử và phương tiện vào ngân sách đầu vào, đồng thời yêu cầu đầu ra có kích thước phù hợp tác vụ. Trang nhà sản xuất còn liệt kê bộ nhớ đệm, xử lý theo lô, Flex và Priority. Khi xử lý các bản ghi độc lập, giữ định danh bản ghi và định dạng kết quả tường minh. Đầu ra là sản phẩm văn bản, ngay cả khi bằng chứng gồm ảnh chụp, âm thanh hoặc video.
Hạn chế có thể gồm bịa đặt thông tin và đôi khi chậm hoặc hết thời gian. Mốc tháng 3 năm 2026 bao gồm các lĩnh vực có kiến thức vẫn giới hạn ở tháng 1 năm 2025, nên đính kèm tài liệu mới hơn hoặc dùng quy trình cung cấp thông tin làm căn cứ được ghi trong tài liệu khi dữ kiện hiện hành quan trọng. Kiểm tra phép tính, tham chiếu nguồn, diễn giải hình ảnh và sửa đổi đề xuất. Cách chuẩn bị đặc trưng cho phiên bản này là đề bài chẩn đoán tập trung, phạm vi công cụ rõ và ràng buộc thiết kế tường minh, tiếp theo là kiểm tra kết quả cụ thể.
", "aboutText": "Gemini 3.6 Flash là cấu hình đa phương thức chủ lực của Google dành cho lập trình, công việc kiến thức và thực thi theo tác tử. Mô hình phát triển từ Gemini 3.5 Flash, tập trung cải thiện hiệu năng đa phương thức và hiệu quả token. Mô hình nhận văn bản, hình ảnh, âm thanh, video và PDF, trả văn bản. Nhiệm vụ hữu ích có thể kết hợp mã, ảnh chụp màn hình và yêu cầu, hoặc so sánh biểu đồ hay bản vẽ trực quan với ràng buộc viết để tạo lời giải thích đã kiểm tra hoặc chỉnh sửa có mục tiêu.\n\nHướng dẫn nhà phát triển nhấn mạnh giảm bước suy luận, lượt và lời gọi công cụ không cần thiết trong công việc nhiều bước, đồng thời chỉnh sửa tập trung hơn. Với chẩn đoán, cung cấp lỗi quan sát được, nguồn liên quan và hành vi cần giữ nguyên. Với gỡ lỗi biểu đồ, yêu cầu mô hình xem vì sao biểu đồ hiển thị sai chuỗi dữ liệu, xác định phép biến đổi dữ liệu liên quan và đề xuất một chỉnh sửa trong khi giữ bố cục xung quanh. Sau đó có thể đối chiếu kết quả với dữ liệu đầu vào thực tế và hành vi biểu đồ yêu cầu.\n\nKiểm tra bằng chương trình ngay từ đầu là hành vi đặc trưng được mô tả cho 3.6. Nhà sản xuất cho biết mô hình thường xuyên hơn dùng mã chẩn đoán để xem vấn đề trước khi thay đổi. Cách này có thể hỗ trợ tìm hiểu phức tạp, nhưng hướng dẫn lưu ý có thể bổ sung bước khám phá cho công việc frontend thông thường. Nêu tác vụ cần điều tra, chỉnh sửa đơn giản hay so sánh thiết kế. Cung cấp thông tin làm rõ khác biệt đó và quy định hành động được phép cho công cụ của ứng dụng kết nối.\n\nSuy luận không gian và đa phương thức cũng được nhấn mạnh: diễn giải biểu đồ, chuyển đổi bản vẽ trực quan và bố cục web nhiều thành phần. Cung cấp góc nhìn hoặc các trang liên quan, xác định nội dung cần diễn giải và yêu cầu bằng chứng đằng sau kết luận. Với tác vụ thiết kế, đưa hướng dẫn bố cục và phong cách cụ thể. Nhà sản xuất lưu ý trọng tâm mã hoạt động được và việc người đánh giá đôi khi thích phong cách hình ảnh của mô hình trước hơn, nên đề bài hình ảnh rõ ràng hữu ích. Đối chiếu kết quả với sơ đồ thực tế hoặc yêu cầu thiết kế.\n\nMedium là mức suy luận mặc định được ghi trong tài liệu. Bảng mức suy luận riêng của mô hình Google liệt kê minimal, low, medium và high; hướng dẫn chuyển đổi 3.6 dùng medium hoặc high trong ví dụ nỗ lực. Trang cụ thể liệt kê gọi hàm, thực thi mã, tìm kiếm tệp, sử dụng kết quả tìm kiếm làm căn cứ, sử dụng thông tin Maps làm căn cứ, ngữ cảnh URL và đầu ra có cấu trúc, với Computer Use là khả năng xem trước. Định nghĩa rõ đầu vào hàm và kết quả bắt buộc. Hàm do mô hình chọn cần kết quả ứng dụng thực tế trước khi câu trả lời sau có thể dựa vào kết quả đó. Với phân tích có cấu trúc, định nghĩa lược đồ và bằng chứng nguồn cần cho từng phát hiện.\n\nHướng dẫn 3.6 thay đổi cách chuẩn bị so với các yêu cầu Gemini trước. Hướng dẫn ngừng khuyến nghị thiết lập lấy mẫu temperature, top-p và top-k, từ chối lượt model cuối được điền sẵn và khuyến nghị chỉ dẫn hệ thống hoặc đầu ra có cấu trúc để điều khiển câu trả lời. Quy tắc phản hồi hàm ghép phản hồi với lời gọi theo định danh và tên, còn nền tảng Gemini 3 giữ chữ ký suy luận khi dùng nhiều lượt. Phần tiếp nối thực tế cần mang theo lịch sử liên quan và kết quả công cụ không sửa đổi thay vì bắt chước tiền tố câu trả lời trước.\n\nThẻ gốc quy định ngữ cảnh đầu vào đến 1M và đầu ra văn bản 64K; bảng API cụ thể ghi 1,048,576 token đầu vào và 65,536 token đầu ra. Tính chỉ dẫn, lịch sử và phương tiện vào ngân sách đầu vào, đồng thời yêu cầu đầu ra có kích thước phù hợp tác vụ. Trang nhà sản xuất còn liệt kê bộ nhớ đệm, xử lý theo lô, Flex và Priority. Khi xử lý các bản ghi độc lập, giữ định danh bản ghi và định dạng kết quả tường minh. Đầu ra là sản phẩm văn bản, ngay cả khi bằng chứng gồm ảnh chụp, âm thanh hoặc video.\n\nHạn chế có thể gồm bịa đặt thông tin và đôi khi chậm hoặc hết thời gian. Mốc tháng 3 năm 2026 bao gồm các lĩnh vực có kiến thức vẫn giới hạn ở tháng 1 năm 2025, nên đính kèm tài liệu mới hơn hoặc dùng quy trình cung cấp thông tin làm căn cứ được ghi trong tài liệu khi dữ kiện hiện hành quan trọng. Kiểm tra phép tính, tham chiếu nguồn, diễn giải hình ảnh và sửa đổi đề xuất. Cách chuẩn bị đặc trưng cho phiên bản này là đề bài chẩn đoán tập trung, phạm vi công cụ rõ và ràng buộc thiết kế tường minh, tiếp theo là kiểm tra kết quả cụ thể.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "8eff8490457abf03b1e968981cfc40160b8d88e1d195584955cdc3cd410f78d6", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "vi", "methods": [ { "html": "google/gemini-3.6-flash:batchGemini 3.6 Flash là mô hình văn bản đa phương thức của Google dành cho lập trình, phân tích không gian và tác tử nhiều bước. Mô hình chú trọng kiểm tra chẩn đoán, chỉnh sửa tập trung và giảm vòng lặp thực thi không cần thiết. Mô hình nhận văn bản, hình ảnh, âm thanh, video và PDF, có công cụ, đầu ra có cấu trúc và giới hạn đầu vào 1,048,576 token.
Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.
Gemini 3.6 Flash là cấu hình đa phương thức chủ lực của Google dành cho lập trình, công việc kiến thức và thực thi theo tác tử. Mô hình phát triển từ Gemini 3.5 Flash, tập trung cải thiện hiệu năng đa phương thức và hiệu quả token. Mô hình nhận văn bản, hình ảnh, âm thanh, video và PDF, trả văn bản. Nhiệm vụ hữu ích có thể kết hợp mã, ảnh chụp màn hình và yêu cầu, hoặc so sánh biểu đồ hay bản vẽ trực quan với ràng buộc viết để tạo lời giải thích đã kiểm tra hoặc chỉnh sửa có mục tiêu.
Hướng dẫn nhà phát triển nhấn mạnh giảm bước suy luận, lượt và lời gọi công cụ không cần thiết trong công việc nhiều bước, đồng thời chỉnh sửa tập trung hơn. Với chẩn đoán, cung cấp lỗi quan sát được, nguồn liên quan và hành vi cần giữ nguyên. Với gỡ lỗi biểu đồ, yêu cầu mô hình xem vì sao biểu đồ hiển thị sai chuỗi dữ liệu, xác định phép biến đổi dữ liệu liên quan và đề xuất một chỉnh sửa trong khi giữ bố cục xung quanh. Sau đó có thể đối chiếu kết quả với dữ liệu đầu vào thực tế và hành vi biểu đồ yêu cầu.
Kiểm tra bằng chương trình ngay từ đầu là hành vi đặc trưng được mô tả cho 3.6. Nhà sản xuất cho biết mô hình thường xuyên hơn dùng mã chẩn đoán để xem vấn đề trước khi thay đổi. Cách này có thể hỗ trợ tìm hiểu phức tạp, nhưng hướng dẫn lưu ý có thể bổ sung bước khám phá cho công việc frontend thông thường. Nêu tác vụ cần điều tra, chỉnh sửa đơn giản hay so sánh thiết kế. Cung cấp thông tin làm rõ khác biệt đó và quy định hành động được phép cho công cụ của ứng dụng kết nối.
Suy luận không gian và đa phương thức cũng được nhấn mạnh: diễn giải biểu đồ, chuyển đổi bản vẽ trực quan và bố cục web nhiều thành phần. Cung cấp góc nhìn hoặc các trang liên quan, xác định nội dung cần diễn giải và yêu cầu bằng chứng đằng sau kết luận. Với tác vụ thiết kế, đưa hướng dẫn bố cục và phong cách cụ thể. Nhà sản xuất lưu ý trọng tâm mã hoạt động được và việc người đánh giá đôi khi thích phong cách hình ảnh của mô hình trước hơn, nên đề bài hình ảnh rõ ràng hữu ích. Đối chiếu kết quả với sơ đồ thực tế hoặc yêu cầu thiết kế.
Medium là mức suy luận mặc định được ghi trong tài liệu. Bảng mức suy luận riêng của mô hình Google liệt kê minimal, low, medium và high; hướng dẫn chuyển đổi 3.6 dùng medium hoặc high trong ví dụ nỗ lực. Trang cụ thể liệt kê gọi hàm, thực thi mã, tìm kiếm tệp, sử dụng kết quả tìm kiếm làm căn cứ, sử dụng thông tin Maps làm căn cứ, ngữ cảnh URL và đầu ra có cấu trúc, với Computer Use là khả năng xem trước. Định nghĩa rõ đầu vào hàm và kết quả bắt buộc. Hàm do mô hình chọn cần kết quả ứng dụng thực tế trước khi câu trả lời sau có thể dựa vào kết quả đó. Với phân tích có cấu trúc, định nghĩa lược đồ và bằng chứng nguồn cần cho từng phát hiện.
Hướng dẫn 3.6 thay đổi cách chuẩn bị so với các yêu cầu Gemini trước. Hướng dẫn ngừng khuyến nghị thiết lập lấy mẫu temperature, top-p và top-k, từ chối lượt model cuối được điền sẵn và khuyến nghị chỉ dẫn hệ thống hoặc đầu ra có cấu trúc để điều khiển câu trả lời. Quy tắc phản hồi hàm ghép phản hồi với lời gọi theo định danh và tên, còn nền tảng Gemini 3 giữ chữ ký suy luận khi dùng nhiều lượt. Phần tiếp nối thực tế cần mang theo lịch sử liên quan và kết quả công cụ không sửa đổi thay vì bắt chước tiền tố câu trả lời trước.
Thẻ gốc quy định ngữ cảnh đầu vào đến 1M và đầu ra văn bản 64K; bảng API cụ thể ghi 1,048,576 token đầu vào và 65,536 token đầu ra. Tính chỉ dẫn, lịch sử và phương tiện vào ngân sách đầu vào, đồng thời yêu cầu đầu ra có kích thước phù hợp tác vụ. Trang nhà sản xuất còn liệt kê bộ nhớ đệm, xử lý theo lô, Flex và Priority. Khi xử lý các bản ghi độc lập, giữ định danh bản ghi và định dạng kết quả tường minh. Đầu ra là sản phẩm văn bản, ngay cả khi bằng chứng gồm ảnh chụp, âm thanh hoặc video.
Hạn chế có thể gồm bịa đặt thông tin và đôi khi chậm hoặc hết thời gian. Mốc tháng 3 năm 2026 bao gồm các lĩnh vực có kiến thức vẫn giới hạn ở tháng 1 năm 2025, nên đính kèm tài liệu mới hơn hoặc dùng quy trình cung cấp thông tin làm căn cứ được ghi trong tài liệu khi dữ kiện hiện hành quan trọng. Kiểm tra phép tính, tham chiếu nguồn, diễn giải hình ảnh và sửa đổi đề xuất. Cách chuẩn bị đặc trưng cho phiên bản này là đề bài chẩn đoán tập trung, phạm vi công cụ rõ và ràng buộc thiết kế tường minh, tiếp theo là kiểm tra kết quả cụ thể.
POST /v1/batchestexttext| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
|---|---|---|---|---|
Trườngendpoint | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn /v1/chat/completions | Mặc định— |
Trườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn google/gemini-3.6-flash:batch | Mặc định— |
Trườngrequests | Loạibatch_item[] | Yêu cầuBắt buộc | Giá trị & giới hạn Số mục tối thiểu: 1 | Mặc định— |
Trườngrequests[].custom_id | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngrequests[].body.messages | Loạimessage[] | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngcompletion_window | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 24h | Mặc định— |
Trườngprovider | Loạiobject|null | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngrequests[].body.model | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn google/gemini-3.6-flash:batch, google/gemini-3.6-flash | Mặc định— |
Trườngprovider.only | Loạistring[] | Yêu cầuKhông bắt buộc | Giá trị & giới hạn google-vertex/global | Mặc định— |
Trườngprovider.allow_fallbacks | Loạiboolean|null | Yêu cầuKhông bắt buộc | Giá trị & giới hạn false, null | Mặc định— |
| Tham số | Hợp đồng |
|---|---|
Tham sốcontent_type | Hợp đồngapplication/json |
Tham sốrequired | Hợp đồngendpoint, model, requests |
Tham sốmaterial_types | Hợp đồngtext |
Tham sốrepresentation | Hợp đồngrequests[] nội tuyến; mỗi phần tử có custom_id và body |
Tham sốrequest_endpoint_profile | Hợp đồng/v1/chat/completions |
Tham sốfile_material | Hợp đồngBên gọi có thể đọc dữ liệu JSONL UTF-8 thực tế trên máy cục bộ vào requests[]. Không sử dụng mục đích tải lên, input_file_id hay tham chiếu tệp. Nếu thiếu tài liệu của khách hàng hoặc tài liệu rỗng, dừng khâu chuẩn bị trước POST. |
Tham sốserialization_order | Hợp đồngendpoint, model, provider (nếu được cung cấp), completion_window (nếu được cung cấp), requests ở cuối |
Tham sốoptional_controls | Hợp đồngprovider.only, provider.allow_fallbacks, completion_window |
Tham sốschema_scope | Hợp đồngPhần thân yêu cầu Chat Completions dạng văn bản trong cấu trúc Batch nội tuyến được mô tả trong tài liệu. |
Vòng đời: asynchronous
GET /v1/batches/{operation_id} · response.id thực tế từ phản hồi tạo gốc; cùng người dùng/khóa/nhóm
Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn.
Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế.
| Cấu hình | Biểu mức phí | Token ngữ cảnh, lớn hơn | Token ngữ cảnh, tối đa và bao gồm | Phí |
|---|---|---|---|---|
| Cấu hìnhGiá cơ sở cho token | Biểu mức phíMức phí cơ bản | Token ngữ cảnh, lớn hơn— | Token ngữ cảnh, tối đa và bao gồmKhông có giới hạn trên | Phí Đầu vào · Token đầu vào $0.00075 / 1K token Đầu ra · Token đầu ra $0.00375 / 1K token Đầu vào · Đọc bộ nhớ đệm $0.000075 / 1K token Đầu vào · Ghi bộ nhớ đệm $0.0000833333333333334 / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ — / 1K token |
| Cấu hìnhBậc 1 theo độ dài yêu cầu | Biểu mức phí— | Token ngữ cảnh, lớn hơn0 | Token ngữ cảnh, tối đa và bao gồmKhông có giới hạn trên | Phí Đầu vào · Token đầu vào $0.00075 / 1K token Đầu ra · Token đầu ra $0.00375 / 1K token Đầu vào · Đọc bộ nhớ đệm $0.000075 / 1K token Đầu vào · Ghi bộ nhớ đệm $0.0000833333333333334 / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ — / 1K token |
Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. Cách hoạt động của cơ chế tạm giữ và quyết toán →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json\nfrom pathlib import Path\nbody=json.loads('{"endpoint":"/v1/chat/completions","model":"google/gemini-3.6-flash:batch","requests":[{"custom_id":"req-0001","body":{"messages":[{"role":"user","content":"Hello!"}],"max_tokens":16}}]}')\nPath("batch-request.json").write_text(json.dumps(body,ensure_ascii=False),encoding="utf-8")\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json\nimport json, os\nfrom pathlib import Path\nfrom urllib.request import Request, urlopen\n\ndef prepare_requests(customer_path):\n path = Path(customer_path)\n if not path.is_file(): raise ValueError("Customer JSONL file is missing")\n items = [json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()]\n if not items: raise ValueError("Customer JSONL contains no requests")\n ids = set()\n for item in items:\n if set(item) != {"custom_id", "body"}: raise ValueError("Each item needs custom_id and body")\n cid = item["custom_id"]\n if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError("custom_id must be nonempty and unique")\n ids.add(cid)\n if not isinstance(item["body"], dict) or not item["body"].get("messages"): raise ValueError("Supply actual text messages")\n supplied_model = item["body"].get("model")\n if supplied_model is not None and supplied_model not in ['google/gemini-3.6-flash:batch', 'google/gemini-3.6-flash']: raise ValueError("body.model must be an exact documented caller or wire ID")\n return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3.6-flash:batch", "requests":items}\n\nif __name__ == "__main__":\n material = os.environ.get("AILOOT_BATCH_REQUESTS_JSONL", "")\n if not material: raise SystemExit("Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file")\n body = prepare_requests(material)\n key = os.environ.get("AILOOT_API_KEY", "")\n if not key: raise SystemExit("Set AILOOT_API_KEY")\n request = Request("https://api.ailoot.ai/v1/batches", data=json.dumps(body, ensure_ascii=False).encode("utf-8"), headers={"Authorization":"Bearer " + key, "Content-Type":"application/json"}, method="POST")\n with urlopen(request) as response:\n raw = response.read()\n Path("batch-create-response.json").write_bytes(raw)\n print(raw.decode("utf-8"))\nimport json\nfrom pathlib import Path\nraw = Path("batch-status-response.json").read_bytes()\nresponse = json.loads(raw)\nif response.get("status") != "completed":\n raise SystemExit("Keep the original operation; read its status without resubmitting")\nresults = response.get("results")\nif not isinstance(results, list) or not results:\n raise SystemExit("Preserve the original response; completed results are missing")\nPath("batch-results.jsonl").write_text("".join(json.dumps(item, ensure_ascii=False) + "\\n" for item in results), encoding="utf-8")\n# Preserve batch-status-response.json with aggregate usage and every result/error.\nJSON nội tuyến tại results[].response.body
GET /v1/batches/{operation_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nBATCH_OPERATION_ID="$(python3 - <<'PY_ID'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nresponse = json.loads(Path("batch-create-response.json").read_text(encoding="utf-8"))\noperation = response.get("id")\nif not isinstance(operation, str) or not operation: raise SystemExit("No actual original operation ID; preserve the response and do not resubmit")\nprint(quote(operation, safe=""))\nPY_ID\n)"\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o batch-status-response.json\nLưu mọi phản hồi hoàn chỉnh, tệp và phần nội dung được trả về.
Giữ lại toàn bộ JSON trạng thái gốc, mọi kết quả/custom_id và toàn bộ phần thân phản hồi hoặc lỗi. Lưu results[] đã hoàn tất dưới dạng JSONL mà không lọc.
Giữ nguyên ID thao tác gốc. Phản hồi 503 result_pending_check có X-Should-Retry:false; tuyệt đối không gửi lại lô gốc có trạng thái chưa xác định.
| Trường | Loại |
|---|---|
Trườngresults[].custom_id | Loạistring |
Trườngresults[].response.body.choices[].message.content | Loạistring|null |
Trườngresults[].error | Loạiobject|null |
Trườngusage | Loạiobject|null |
Trườngid | Loạistring |
Trườngmodel | Loạistring |
Trườngendpoint | Loạistring |
Trườngstatus | Loạistring |
Trườngrequest_counts | Loạiobject |
Trườngresults[].id | Loạistring |
Trườngresults[].response.status_code | Loạiinteger |
Trườngresults[].response.request_id | Loạistring |
| Phản hồi | Điều kiện | Bước tiếp theo |
|---|---|---|
Phản hồi400 · invalid_request_error | Điều kiệnCấu trúc nội tuyến không đúng tài liệu, có khóa trùng, định danh phần tử không hợp lệ hoặc xung đột với khả năng đã cấu hình của mô hình. | Bước tiếp theoSửa các trường được chỉ ra trước khi gửi bất kỳ yêu cầu mới nào. |
Phản hồi401 · authentication_error | Điều kiệnKhóa API không hợp lệ. | Bước tiếp theoSử dụng khóa Ailoot đã được cấp quyền. |
Phản hồi403 · permission_error | Điều kiệnNhóm xử lý hàng loạt không khả dụng. | Bước tiếp theoKiểm tra quyền sử dụng của khóa/nhóm. |
Phản hồi422 · invalid_request_error | Điều kiệnXử lý hàng loạt tính phí từ số dư; yêu cầu tạo qua gói thuê bao bị từ chối. | Bước tiếp theoSử dụng nhóm đã được cấp quyền và tính phí từ số dư. |
Phản hồi422 · price_unavailable | Điều kiệnKhông thể báo giá cho dữ liệu đầu vào của lô. | Bước tiếp theoGiữ lại phản hồi; sử dụng dữ liệu đầu vào của họ API được mô tả trong tài liệu. |
Phản hồi402 · billing_error | Điều kiệnKhoản dự trữ cho xử lý hàng loạt không khả dụng. | Bước tiếp theoKhắc phục vấn đề về điều kiện tiếp nhận trước khi gửi yêu cầu mới. |
Phản hồi503 · price_unavailable | Điều kiệnGiá phương thức xử lý hàng loạt/đơn giá gốc không khả dụng. | Bước tiếp theoGiữ lại phản hồi; không thay thế đơn giá. |
Phản hồi503 · api_error | Điều kiệnTuyến cụ thể tới nhà cung cấp không khả dụng. | Bước tiếp theoGiữ lại phản hồi để sửa tuyến. |
Phản hồi503 · result_pending_check | Điều kiệnKết quả gốc cần được kiểm tra; X-Should-Retry:false. | Bước tiếp theoGiữ lại operation_id/id gốc và truy xuất trạng thái của thao tác đó; tuyệt đối không lặp lại POST gốc. |
Phản hồi404 · not_found | Điều kiệnKhông tìm thấy thao tác kiểm tra trạng thái lô hoặc thao tác thuộc một danh tính khác. | Bước tiếp theoSử dụng đúng id gốc và cùng người dùng/khóa/nhóm. |
Ailoot Ultra google/gemini-3.6-flash:batch
Dùng các đường dẫn phương thức hiển thị ở trên.