Gemini 3.7 Flash là cấu hình suy luận đa phương thức có tên riêng của Google dành cho lập trình, quy trình tác tử và thực thi nhiều bước. Mô hình phát triển từ Gemini 3.6 Flash, với thay đổi thuật toán suy luận và hỗ trợ hiểu video theo tác tử. Văn bản, hình ảnh, âm thanh, video và PDF có thể tạo thành tài liệu nguồn cho kết quả văn bản. Sản phẩm hữu ích gồm sửa mã tập trung, so sánh bản mẫu thiết kế với triển khai hoặc phân tích sự kiện trong bản ghi dựa trên nguồn.
Hướng dẫn nhà phát triển 3.7 nhấn mạnh khả năng bám sát thiết kế tốt hơn trong công việc máy tính để bàn và web. Với tác vụ đó, cung cấp bản mẫu mong muốn, nguồn liên quan và sai khác quan sát được. Yêu cầu so sánh theo yếu tố cụ thể như khoảng cách, trạng thái thành phần, thứ bậc văn bản hoặc hành vi tương tác. Khi so sánh thiết kế, yêu cầu danh sách điểm không khớp giữa bản mẫu bảng cài đặt và triển khai hiện tại, với mỗi chỉnh sửa đề xuất gắn với ảnh chụp hoặc nguồn. Kết quả cần xác định phần phải đổi mà không âm thầm mở rộng thiết kế ngoài yêu cầu được cung cấp.
Với quy trình lập trình, đưa mục tiêu, hành vi hiện có, tệp liên quan và ràng buộc. Google định vị 3.7 để giải quyết vấn đề phần mềm và giảm vòng lặp tác tử thất bại, nhưng việc kiểm tra hữu ích vẫn xem thay đổi thực tế và kết quả xác thực. Giữ chuỗi quan sát công cụ trong hội thoại để bước sau không bắt đầu từ bản mô tả kho mã tự bịa. Kết quả cuối có thể phân biệt thay đổi đề xuất với thay đổi được xác nhận qua công cụ của ứng dụng kết nối.
Các mức suy luận được ghi trong tài liệu là low, medium và high, mặc định medium. Low hỗ trợ câu trả lời có giới hạn nhanh hơn, còn high dành cho suy luận khó và công việc công cụ kéo dài. Gemini 3.7 Flash không hỗ trợ suy luận minimal. Vì vậy, phân tích ngắn một sai khác giao diện và tìm hiểu sâu nhiều tệp cần lựa chọn nỗ lực khác nhau. Xác định sản phẩm cuối và điều kiện phải đáp ứng trước khi yêu cầu chuỗi suy luận và hành động dài hơn.
Trang mô hình 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ứ và ngữ cảnh URL. Computer Use được đánh dấu xem trước, còn đầu ra có cấu trúc có thể định nghĩa bản ghi kết quả. Yêu cầu hàm là thao tác đề xuất để ứng dụng kết nối thực thi và trả kết quả. Với tác vụ tác tử, giao mục đích rõ cho công cụ và giữ kết quả thực tế trước khi yêu cầu mô hình tiếp tục. Với trích xuất tài liệu, định nghĩa trường, giá trị chấp nhận và cách biểu diễn thông tin thiếu.
Phiên bản này hỗ trợ hiểu video theo tác tử. Cung cấp bản ghi liên quan và nêu sự kiện hoặc quan hệ cần xem. Đề bài thực tế có thể hỏi hành động nhìn thấy nào giải thích sự đổi trạng thái, hoặc yêu cầu mô tả sự kiện theo thứ tự với bằng chứng từ đoạn phim. Tương tự, hình ảnh và trang PDF có thể hỗ trợ so sánh trực quan hoặc tài liệu. Đầu ra vẫn là văn bản: diễn giải, dữ liệu trích xuất, mã hoặc lời giải thích viết. Tạo video, hình nghệ thuật hoặc giọng nói thuộc các cấu hình mô hình riêng.
Bảng API 3.7 cụ thể của Google quy định 1,048,576 token đầu vào và 65,536 token đầu ra, còn thẻ gốc mô tả ngữ cảnh đến 1M và đầu ra văn bản 64K. Tính cả chỉ dẫn, lượt trước và phương tiện được cung cấp khi chuẩn bị đầu vào. Xử lý theo lô và bộ nhớ đệm được liệt kê cho cấu hình nhà sản xuất, cùng lựa chọn Flex và Priority. Với tập yêu cầu độc lập, giữ định danh nguồn và định dạng kết quả nhất quán để mỗi câu trả lời có thể được đối chiếu với đầu vào riêng.
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 cập nhật kiến thức là tháng 3 năm 2026, một số lĩnh vực giới hạn ở tháng 1 năm 2025. Cung cấp tài liệu nguồn hiện hành khi kết luận phụ thuộc dữ kiện gần đây hơn. Điểm khác biệt hữu ích của phiên bản này là trọng tâm được ghi trong tài liệu về vấn đề phần mềm, tuân thủ thiết kế và suy luận video; kiểm tra kết quả theo bản mẫu, mã hoặc phương tiện thực tế thay vì gán tính năng mới hơn cho một cấu hình lịch sử có tên riêng.
", "aboutText": "Gemini 3.7 Flash là cấu hình suy luận đa phương thức có tên riêng của Google dành cho lập trình, quy trình tác tử và thực thi nhiều bước. Mô hình phát triển từ Gemini 3.6 Flash, với thay đổi thuật toán suy luận và hỗ trợ hiểu video theo tác tử. Văn bản, hình ảnh, âm thanh, video và PDF có thể tạo thành tài liệu nguồn cho kết quả văn bản. Sản phẩm hữu ích gồm sửa mã tập trung, so sánh bản mẫu thiết kế với triển khai hoặc phân tích sự kiện trong bản ghi dựa trên nguồn.\n\nHướng dẫn nhà phát triển 3.7 nhấn mạnh khả năng bám sát thiết kế tốt hơn trong công việc máy tính để bàn và web. Với tác vụ đó, cung cấp bản mẫu mong muốn, nguồn liên quan và sai khác quan sát được. Yêu cầu so sánh theo yếu tố cụ thể như khoảng cách, trạng thái thành phần, thứ bậc văn bản hoặc hành vi tương tác. Khi so sánh thiết kế, yêu cầu danh sách điểm không khớp giữa bản mẫu bảng cài đặt và triển khai hiện tại, với mỗi chỉnh sửa đề xuất gắn với ảnh chụp hoặc nguồn. Kết quả cần xác định phần phải đổi mà không âm thầm mở rộng thiết kế ngoài yêu cầu được cung cấp.\n\nVới quy trình lập trình, đưa mục tiêu, hành vi hiện có, tệp liên quan và ràng buộc. Google định vị 3.7 để giải quyết vấn đề phần mềm và giảm vòng lặp tác tử thất bại, nhưng việc kiểm tra hữu ích vẫn xem thay đổi thực tế và kết quả xác thực. Giữ chuỗi quan sát công cụ trong hội thoại để bước sau không bắt đầu từ bản mô tả kho mã tự bịa. Kết quả cuối có thể phân biệt thay đổi đề xuất với thay đổi được xác nhận qua công cụ của ứng dụng kết nối.\n\nCác mức suy luận được ghi trong tài liệu là low, medium và high, mặc định medium. Low hỗ trợ câu trả lời có giới hạn nhanh hơn, còn high dành cho suy luận khó và công việc công cụ kéo dài. Gemini 3.7 Flash không hỗ trợ suy luận minimal. Vì vậy, phân tích ngắn một sai khác giao diện và tìm hiểu sâu nhiều tệp cần lựa chọn nỗ lực khác nhau. Xác định sản phẩm cuối và điều kiện phải đáp ứng trước khi yêu cầu chuỗi suy luận và hành động dài hơn.\n\nTrang mô hình 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ứ và ngữ cảnh URL. Computer Use được đánh dấu xem trước, còn đầu ra có cấu trúc có thể định nghĩa bản ghi kết quả. Yêu cầu hàm là thao tác đề xuất để ứng dụng kết nối thực thi và trả kết quả. Với tác vụ tác tử, giao mục đích rõ cho công cụ và giữ kết quả thực tế trước khi yêu cầu mô hình tiếp tục. Với trích xuất tài liệu, định nghĩa trường, giá trị chấp nhận và cách biểu diễn thông tin thiếu.\n\nPhiên bản này hỗ trợ hiểu video theo tác tử. Cung cấp bản ghi liên quan và nêu sự kiện hoặc quan hệ cần xem. Đề bài thực tế có thể hỏi hành động nhìn thấy nào giải thích sự đổi trạng thái, hoặc yêu cầu mô tả sự kiện theo thứ tự với bằng chứng từ đoạn phim. Tương tự, hình ảnh và trang PDF có thể hỗ trợ so sánh trực quan hoặc tài liệu. Đầu ra vẫn là văn bản: diễn giải, dữ liệu trích xuất, mã hoặc lời giải thích viết. Tạo video, hình nghệ thuật hoặc giọng nói thuộc các cấu hình mô hình riêng.\n\nBảng API 3.7 cụ thể của Google quy định 1,048,576 token đầu vào và 65,536 token đầu ra, còn thẻ gốc mô tả ngữ cảnh đến 1M và đầu ra văn bản 64K. Tính cả chỉ dẫn, lượt trước và phương tiện được cung cấp khi chuẩn bị đầu vào. Xử lý theo lô và bộ nhớ đệm được liệt kê cho cấu hình nhà sản xuất, cùng lựa chọn Flex và Priority. Với tập yêu cầu độc lập, giữ định danh nguồn và định dạng kết quả nhất quán để mỗi câu trả lời có thể được đối chiếu với đầu vào riêng.\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 cập nhật kiến thức là tháng 3 năm 2026, một số lĩnh vực giới hạn ở tháng 1 năm 2025. Cung cấp tài liệu nguồn hiện hành khi kết luận phụ thuộc dữ kiện gần đây hơn. Điểm khác biệt hữu ích của phiên bản này là trọng tâm được ghi trong tài liệu về vấn đề phần mềm, tuân thủ thiết kế và suy luận video; kiểm tra kết quả theo bản mẫu, mã hoặc phương tiện thực tế thay vì gán tính năng mới hơn cho một cấu hình lịch sử có tên riêng.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "8ea2148a598c1c9d4c6f3dfd7e29766553257bb0630ebfe395f0cc291d868b64", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "vi", "methods": [ { "html": "google/gemini-3.7-flash:batchGemini 3.7 Flash kết hợp suy luận đa phương thức với lập trình và công việc tác tử nhiều bước. Cấu hình 3.7 của Google chú trọng độ bám sát bản mẫu thiết kế và hiểu video theo tác tử, với mức suy luận low, medium và high. Mô hình nhận văn bản và phương tiện, trả văn bản, có giới hạn đầu vào/đầu ra 1,048,576/65,536 token được ghi trong tài liệu.
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.7 Flash là cấu hình suy luận đa phương thức có tên riêng của Google dành cho lập trình, quy trình tác tử và thực thi nhiều bước. Mô hình phát triển từ Gemini 3.6 Flash, với thay đổi thuật toán suy luận và hỗ trợ hiểu video theo tác tử. Văn bản, hình ảnh, âm thanh, video và PDF có thể tạo thành tài liệu nguồn cho kết quả văn bản. Sản phẩm hữu ích gồm sửa mã tập trung, so sánh bản mẫu thiết kế với triển khai hoặc phân tích sự kiện trong bản ghi dựa trên nguồn.
Hướng dẫn nhà phát triển 3.7 nhấn mạnh khả năng bám sát thiết kế tốt hơn trong công việc máy tính để bàn và web. Với tác vụ đó, cung cấp bản mẫu mong muốn, nguồn liên quan và sai khác quan sát được. Yêu cầu so sánh theo yếu tố cụ thể như khoảng cách, trạng thái thành phần, thứ bậc văn bản hoặc hành vi tương tác. Khi so sánh thiết kế, yêu cầu danh sách điểm không khớp giữa bản mẫu bảng cài đặt và triển khai hiện tại, với mỗi chỉnh sửa đề xuất gắn với ảnh chụp hoặc nguồn. Kết quả cần xác định phần phải đổi mà không âm thầm mở rộng thiết kế ngoài yêu cầu được cung cấp.
Với quy trình lập trình, đưa mục tiêu, hành vi hiện có, tệp liên quan và ràng buộc. Google định vị 3.7 để giải quyết vấn đề phần mềm và giảm vòng lặp tác tử thất bại, nhưng việc kiểm tra hữu ích vẫn xem thay đổi thực tế và kết quả xác thực. Giữ chuỗi quan sát công cụ trong hội thoại để bước sau không bắt đầu từ bản mô tả kho mã tự bịa. Kết quả cuối có thể phân biệt thay đổi đề xuất với thay đổi được xác nhận qua công cụ của ứng dụng kết nối.
Các mức suy luận được ghi trong tài liệu là low, medium và high, mặc định medium. Low hỗ trợ câu trả lời có giới hạn nhanh hơn, còn high dành cho suy luận khó và công việc công cụ kéo dài. Gemini 3.7 Flash không hỗ trợ suy luận minimal. Vì vậy, phân tích ngắn một sai khác giao diện và tìm hiểu sâu nhiều tệp cần lựa chọn nỗ lực khác nhau. Xác định sản phẩm cuối và điều kiện phải đáp ứng trước khi yêu cầu chuỗi suy luận và hành động dài hơn.
Trang mô hình 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ứ và ngữ cảnh URL. Computer Use được đánh dấu xem trước, còn đầu ra có cấu trúc có thể định nghĩa bản ghi kết quả. Yêu cầu hàm là thao tác đề xuất để ứng dụng kết nối thực thi và trả kết quả. Với tác vụ tác tử, giao mục đích rõ cho công cụ và giữ kết quả thực tế trước khi yêu cầu mô hình tiếp tục. Với trích xuất tài liệu, định nghĩa trường, giá trị chấp nhận và cách biểu diễn thông tin thiếu.
Phiên bản này hỗ trợ hiểu video theo tác tử. Cung cấp bản ghi liên quan và nêu sự kiện hoặc quan hệ cần xem. Đề bài thực tế có thể hỏi hành động nhìn thấy nào giải thích sự đổi trạng thái, hoặc yêu cầu mô tả sự kiện theo thứ tự với bằng chứng từ đoạn phim. Tương tự, hình ảnh và trang PDF có thể hỗ trợ so sánh trực quan hoặc tài liệu. Đầu ra vẫn là văn bản: diễn giải, dữ liệu trích xuất, mã hoặc lời giải thích viết. Tạo video, hình nghệ thuật hoặc giọng nói thuộc các cấu hình mô hình riêng.
Bảng API 3.7 cụ thể của Google quy định 1,048,576 token đầu vào và 65,536 token đầu ra, còn thẻ gốc mô tả ngữ cảnh đến 1M và đầu ra văn bản 64K. Tính cả chỉ dẫn, lượt trước và phương tiện được cung cấp khi chuẩn bị đầu vào. Xử lý theo lô và bộ nhớ đệm được liệt kê cho cấu hình nhà sản xuất, cùng lựa chọn Flex và Priority. Với tập yêu cầu độc lập, giữ định danh nguồn và định dạng kết quả nhất quán để mỗi câu trả lời có thể được đối chiếu với đầu vào riêng.
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 cập nhật kiến thức là tháng 3 năm 2026, một số lĩnh vực giới hạn ở tháng 1 năm 2025. Cung cấp tài liệu nguồn hiện hành khi kết luận phụ thuộc dữ kiện gần đây hơn. Điểm khác biệt hữu ích của phiên bản này là trọng tâm được ghi trong tài liệu về vấn đề phần mềm, tuân thủ thiết kế và suy luận video; kiểm tra kết quả theo bản mẫu, mã hoặc phương tiện thực tế thay vì gán tính năng mới hơn cho một cấu hình lịch sử có tên riêng.
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.7-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.7-flash:batch, google/gemini-3.7-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.7-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.7-flash:batch', 'google/gemini-3.7-flash']: raise ValueError("body.model must be an exact documented caller or wire ID")\n return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3.7-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.7-flash:batch
Dùng các đường dẫn phương thức hiển thị ở trên.