Gemini 2.5 Flash-Lite là cấu hình nhẹ bản ổn định của Google dành cho dịch thuật, phân loại và trích xuất dữ liệu đơn giản với khối lượng lớn. Suy luận lai có thể dùng hoặc bỏ suy nghĩ tùy tác vụ. Mô hình nhận văn bản, hình ảnh, âm thanh, video và PDF rồi tạo văn bản. Kết quả hữu ích là danh mục, bản dịch ngắn gọn, bản ghi trích xuất từ tài liệu được cung cấp hoặc lời giải thích bằng chữ trong phạm vi giới hạn.
Đối với phân loại, định nghĩa danh mục, quy tắc quyết định và hình thức câu trả lời. Giữ mã định danh nguồn trong kết quả khi xử lý nhiều mục độc lập. Với phân loại tin nhắn hỗ trợ, phân loại tin nhắn theo loại vấn đề và trả về câu làm cơ sở cho danh mục đó. Đưa vào quy tắc cho bằng chứng thiếu hoặc mơ hồ để câu trả lời trôi chảy không điền trường bắt buộc bằng phỏng đoán. Vai trò nhẹ của mô hình hữu ích nhất khi đầu vào và kết quả yêu cầu được xác định rõ.
Suy nghĩ được tắt mặc định trong cấu hình 2.5 Flash-Lite được tài liệu hóa. Hướng dẫn suy nghĩ GenerateContent của Google cho phép ngân sách suy nghĩ được chỉ định rõ từ 512 đến 24,576 token, giá trị 0 để giữ suy nghĩ ở trạng thái tắt và -1 để yêu cầu suy nghĩ động. Đây là điều khiển ngân sách suy luận, khác với hạn mức phản hồi cuối. Bật suy luận bổ sung khi trích xuất có các điều kiện tương tác hoặc phân loại có ngoại lệ; phép chuyển đổi đơn giản có thể giữ hành vi không suy nghĩ mặc định. Hướng dẫn lưu ý mô hình có thể dùng nhiều hoặc ít token suy nghĩ hơn ngân sách được yêu cầu.
Đối với dịch thuật, cung cấp ngôn ngữ đích, đối tượng đọc và thuật ngữ cần giữ nguyên. Chỉ định kết quả chỉ chứa bản dịch hay bản ghi có nhãn. Với trích xuất tài liệu, định nghĩa trường và yêu cầu đoạn nguồn giúp kiểm tra đầu ra. Với bản ghi, phân biệt bản chép lời với bản tóm tắt và xác định đoạn quan trọng. Hình ảnh hoặc video có thể đóng góp bằng chứng cho câu trả lời văn bản. Sản phẩm mong muốn cần tiếp tục rõ ràng ngay cả khi đầu vào kết hợp nhiều loại phương tiện.
Bảng dành riêng cho bản ổn định liệt kê gọi hàm, thực thi mã, tìm kiếm tệp, grounding bằng tìm kiếm, grounding bằng Maps, ngữ cảnh URL và đầu ra có cấu trúc. Hàm cần mục đích rõ ràng và tham số được định nghĩa; ứng dụng kết nối thực thi thao tác và cung cấp kết quả. Với trích xuất dựa trên lược đồ, kiểm tra cấu trúc trả về và đối chiếu giá trị với tài liệu gốc. Quyết định dùng công cụ hoặc bản ghi đúng định dạng chỉ hữu ích trong ngữ cảnh nguồn và bằng chứng thực tế được trả về.
Thẻ gốc đưa ra cửa sổ ngữ cảnh 1M và đầu ra văn bản 64K. Trang mô hình API quy định 1,048,576 token đầu vào và 65,536 token đầu ra. Chỉ dẫn, nội dung nguồn và hội thoại được giữ lại tiêu thụ ngân sách đầu vào, trong khi suy luận và giới hạn phản hồi ảnh hưởng đến việc kết quả cuối có vừa hay không. Bộ nhớ đệm, xử lý hàng loạt, Flex và Priority được liệt kê cho cấu hình này của nhà sản xuất. Với tác vụ lặp lại, giữ cùng định nghĩa danh mục hoặc trường và mang mã định danh qua kết quả để việc xem xét sau này tìm được mục gốc.
Cấu hình ổn định này riêng biệt với các biến thể Preview tháng 6 và tháng 9 được mô tả ở nơi khác trong dòng. Thẻ gốc chung ghi nhãn các cải thiện của September Preview, gồm tuân thủ chỉ dẫn và tính ngắn gọn, dành riêng cho bản preview đó; không nên ngầm chuyển chúng sang mã bản ổn định. Các thế hệ Flash-Lite ra sau cũng dùng điều khiển suy nghĩ và bảng khả năng khác. Giữ phiên bản và chọn thiết lập được tài liệu hóa cho nó thay vì thay ngân sách 2.5 bằng cú pháp mức suy nghĩ Gemini 3.
Thẻ liệt kê khả năng tạo thông tin sai và hạn chế về hiểu quan hệ nhân quả, suy diễn logic phức tạp cùng suy luận phản thực, đồng thời đưa ra mốc kiến thức tháng 1 năm 2025. Cung cấp bằng chứng hiện tại hoặc dùng quy trình grounding được tài liệu hóa khi dữ kiện mới quan trọng. Kiểm tra bản dịch về ý nghĩa, trường trích xuất về cơ sở nguồn và bản chép lời theo âm thanh. Kết quả nhỏ, tập trung giúp việc kiểm tra này thực tế mà không xem câu trả lời được trau chuốt là bằng chứng rằng nguồn chứa chi tiết được khẳng định.
", "aboutText": "Gemini 2.5 Flash-Lite là cấu hình nhẹ bản ổn định của Google dành cho dịch thuật, phân loại và trích xuất dữ liệu đơn giản với khối lượng lớn. Suy luận lai có thể dùng hoặc bỏ suy nghĩ tùy tác vụ. Mô hình nhận văn bản, hình ảnh, âm thanh, video và PDF rồi tạo văn bản. Kết quả hữu ích là danh mục, bản dịch ngắn gọn, bản ghi trích xuất từ tài liệu được cung cấp hoặc lời giải thích bằng chữ trong phạm vi giới hạn.\n\nĐối với phân loại, định nghĩa danh mục, quy tắc quyết định và hình thức câu trả lời. Giữ mã định danh nguồn trong kết quả khi xử lý nhiều mục độc lập. Với phân loại tin nhắn hỗ trợ, phân loại tin nhắn theo loại vấn đề và trả về câu làm cơ sở cho danh mục đó. Đưa vào quy tắc cho bằng chứng thiếu hoặc mơ hồ để câu trả lời trôi chảy không điền trường bắt buộc bằng phỏng đoán. Vai trò nhẹ của mô hình hữu ích nhất khi đầu vào và kết quả yêu cầu được xác định rõ.\n\nSuy nghĩ được tắt mặc định trong cấu hình 2.5 Flash-Lite được tài liệu hóa. Hướng dẫn suy nghĩ GenerateContent của Google cho phép ngân sách suy nghĩ được chỉ định rõ từ 512 đến 24,576 token, giá trị 0 để giữ suy nghĩ ở trạng thái tắt và -1 để yêu cầu suy nghĩ động. Đây là điều khiển ngân sách suy luận, khác với hạn mức phản hồi cuối. Bật suy luận bổ sung khi trích xuất có các điều kiện tương tác hoặc phân loại có ngoại lệ; phép chuyển đổi đơn giản có thể giữ hành vi không suy nghĩ mặc định. Hướng dẫn lưu ý mô hình có thể dùng nhiều hoặc ít token suy nghĩ hơn ngân sách được yêu cầu.\n\nĐối với dịch thuật, cung cấp ngôn ngữ đích, đối tượng đọc và thuật ngữ cần giữ nguyên. Chỉ định kết quả chỉ chứa bản dịch hay bản ghi có nhãn. Với trích xuất tài liệu, định nghĩa trường và yêu cầu đoạn nguồn giúp kiểm tra đầu ra. Với bản ghi, phân biệt bản chép lời với bản tóm tắt và xác định đoạn quan trọng. Hình ảnh hoặc video có thể đóng góp bằng chứng cho câu trả lời văn bản. Sản phẩm mong muốn cần tiếp tục rõ ràng ngay cả khi đầu vào kết hợp nhiều loại phương tiện.\n\nBảng dành riêng cho bản ổn định liệt kê gọi hàm, thực thi mã, tìm kiếm tệp, grounding bằng tìm kiếm, grounding bằng Maps, ngữ cảnh URL và đầu ra có cấu trúc. Hàm cần mục đích rõ ràng và tham số được định nghĩa; ứng dụng kết nối thực thi thao tác và cung cấp kết quả. Với trích xuất dựa trên lược đồ, kiểm tra cấu trúc trả về và đối chiếu giá trị với tài liệu gốc. Quyết định dùng công cụ hoặc bản ghi đúng định dạng chỉ hữu ích trong ngữ cảnh nguồn và bằng chứng thực tế được trả về.\n\nThẻ gốc đưa ra cửa sổ ngữ cảnh 1M và đầu ra văn bản 64K. Trang mô hình API quy định 1,048,576 token đầu vào và 65,536 token đầu ra. Chỉ dẫn, nội dung nguồn và hội thoại được giữ lại tiêu thụ ngân sách đầu vào, trong khi suy luận và giới hạn phản hồi ảnh hưởng đến việc kết quả cuối có vừa hay không. Bộ nhớ đệm, xử lý hàng loạt, Flex và Priority được liệt kê cho cấu hình này của nhà sản xuất. Với tác vụ lặp lại, giữ cùng định nghĩa danh mục hoặc trường và mang mã định danh qua kết quả để việc xem xét sau này tìm được mục gốc.\n\nCấu hình ổn định này riêng biệt với các biến thể Preview tháng 6 và tháng 9 được mô tả ở nơi khác trong dòng. Thẻ gốc chung ghi nhãn các cải thiện của September Preview, gồm tuân thủ chỉ dẫn và tính ngắn gọn, dành riêng cho bản preview đó; không nên ngầm chuyển chúng sang mã bản ổn định. Các thế hệ Flash-Lite ra sau cũng dùng điều khiển suy nghĩ và bảng khả năng khác. Giữ phiên bản và chọn thiết lập được tài liệu hóa cho nó thay vì thay ngân sách 2.5 bằng cú pháp mức suy nghĩ Gemini 3.\n\nThẻ liệt kê khả năng tạo thông tin sai và hạn chế về hiểu quan hệ nhân quả, suy diễn logic phức tạp cùng suy luận phản thực, đồng thời đưa ra mốc kiến thức tháng 1 năm 2025. Cung cấp bằng chứng hiện tại hoặc dùng quy trình grounding được tài liệu hóa khi dữ kiện mới quan trọng. Kiểm tra bản dịch về ý nghĩa, trường trích xuất về cơ sở nguồn và bản chép lời theo âm thanh. Kết quả nhỏ, tập trung giúp việc kiểm tra này thực tế mà không xem câu trả lời được trau chuốt là bằng chứng rằng nguồn chứa chi tiết được khẳng định.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "039eba5cb660bad06ef54d223213b27b9d6cd88e7523c3bb203734be1ad2cec0", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "vi", "methods": [ { "html": "google/gemini-2.5-flash-lite:batchGemini 2.5 Flash-Lite là mô hình văn bản đa phương thức bản ổn định của Google dành cho phân loại, dịch thuật thường xuyên và trích xuất đơn giản. Suy nghĩ được tắt mặc định và có thể bật với ngân sách suy luận 512–24,576 token. Mô hình nhận văn bản và phương tiện, với 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 2.5 Flash-Lite là cấu hình nhẹ bản ổn định của Google dành cho dịch thuật, phân loại và trích xuất dữ liệu đơn giản với khối lượng lớn. Suy luận lai có thể dùng hoặc bỏ suy nghĩ tùy tác vụ. Mô hình nhận văn bản, hình ảnh, âm thanh, video và PDF rồi tạo văn bản. Kết quả hữu ích là danh mục, bản dịch ngắn gọn, bản ghi trích xuất từ tài liệu được cung cấp hoặc lời giải thích bằng chữ trong phạm vi giới hạn.
Đối với phân loại, định nghĩa danh mục, quy tắc quyết định và hình thức câu trả lời. Giữ mã định danh nguồn trong kết quả khi xử lý nhiều mục độc lập. Với phân loại tin nhắn hỗ trợ, phân loại tin nhắn theo loại vấn đề và trả về câu làm cơ sở cho danh mục đó. Đưa vào quy tắc cho bằng chứng thiếu hoặc mơ hồ để câu trả lời trôi chảy không điền trường bắt buộc bằng phỏng đoán. Vai trò nhẹ của mô hình hữu ích nhất khi đầu vào và kết quả yêu cầu được xác định rõ.
Suy nghĩ được tắt mặc định trong cấu hình 2.5 Flash-Lite được tài liệu hóa. Hướng dẫn suy nghĩ GenerateContent của Google cho phép ngân sách suy nghĩ được chỉ định rõ từ 512 đến 24,576 token, giá trị 0 để giữ suy nghĩ ở trạng thái tắt và -1 để yêu cầu suy nghĩ động. Đây là điều khiển ngân sách suy luận, khác với hạn mức phản hồi cuối. Bật suy luận bổ sung khi trích xuất có các điều kiện tương tác hoặc phân loại có ngoại lệ; phép chuyển đổi đơn giản có thể giữ hành vi không suy nghĩ mặc định. Hướng dẫn lưu ý mô hình có thể dùng nhiều hoặc ít token suy nghĩ hơn ngân sách được yêu cầu.
Đối với dịch thuật, cung cấp ngôn ngữ đích, đối tượng đọc và thuật ngữ cần giữ nguyên. Chỉ định kết quả chỉ chứa bản dịch hay bản ghi có nhãn. Với trích xuất tài liệu, định nghĩa trường và yêu cầu đoạn nguồn giúp kiểm tra đầu ra. Với bản ghi, phân biệt bản chép lời với bản tóm tắt và xác định đoạn quan trọng. Hình ảnh hoặc video có thể đóng góp bằng chứng cho câu trả lời văn bản. Sản phẩm mong muốn cần tiếp tục rõ ràng ngay cả khi đầu vào kết hợp nhiều loại phương tiện.
Bảng dành riêng cho bản ổn định liệt kê gọi hàm, thực thi mã, tìm kiếm tệp, grounding bằng tìm kiếm, grounding bằng Maps, ngữ cảnh URL và đầu ra có cấu trúc. Hàm cần mục đích rõ ràng và tham số được định nghĩa; ứng dụng kết nối thực thi thao tác và cung cấp kết quả. Với trích xuất dựa trên lược đồ, kiểm tra cấu trúc trả về và đối chiếu giá trị với tài liệu gốc. Quyết định dùng công cụ hoặc bản ghi đúng định dạng chỉ hữu ích trong ngữ cảnh nguồn và bằng chứng thực tế được trả về.
Thẻ gốc đưa ra cửa sổ ngữ cảnh 1M và đầu ra văn bản 64K. Trang mô hình API quy định 1,048,576 token đầu vào và 65,536 token đầu ra. Chỉ dẫn, nội dung nguồn và hội thoại được giữ lại tiêu thụ ngân sách đầu vào, trong khi suy luận và giới hạn phản hồi ảnh hưởng đến việc kết quả cuối có vừa hay không. Bộ nhớ đệm, xử lý hàng loạt, Flex và Priority được liệt kê cho cấu hình này của nhà sản xuất. Với tác vụ lặp lại, giữ cùng định nghĩa danh mục hoặc trường và mang mã định danh qua kết quả để việc xem xét sau này tìm được mục gốc.
Cấu hình ổn định này riêng biệt với các biến thể Preview tháng 6 và tháng 9 được mô tả ở nơi khác trong dòng. Thẻ gốc chung ghi nhãn các cải thiện của September Preview, gồm tuân thủ chỉ dẫn và tính ngắn gọn, dành riêng cho bản preview đó; không nên ngầm chuyển chúng sang mã bản ổn định. Các thế hệ Flash-Lite ra sau cũng dùng điều khiển suy nghĩ và bảng khả năng khác. Giữ phiên bản và chọn thiết lập được tài liệu hóa cho nó thay vì thay ngân sách 2.5 bằng cú pháp mức suy nghĩ Gemini 3.
Thẻ liệt kê khả năng tạo thông tin sai và hạn chế về hiểu quan hệ nhân quả, suy diễn logic phức tạp cùng suy luận phản thực, đồng thời đưa ra mốc kiến thức tháng 1 năm 2025. Cung cấp bằng chứng hiện tại hoặc dùng quy trình grounding được tài liệu hóa khi dữ kiện mới quan trọng. Kiểm tra bản dịch về ý nghĩa, trường trích xuất về cơ sở nguồn và bản chép lời theo âm thanh. Kết quả nhỏ, tập trung giúp việc kiểm tra này thực tế mà không xem câu trả lời được trau chuốt là bằng chứng rằng nguồn chứa chi tiết được khẳng định.
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-2.5-flash-lite: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-2.5-flash-lite:batch, google/gemini-2.5-flash-lite | Mặc định— |
Trườngprovider.only | Loạistring[] | Yêu cầuKhông bắt buộc | Giá trị & giới hạn google-ai-studio | 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.0001 / 1K token Đầu ra · Token đầu ra $0.0004 / 1K token Đầu vào · Đọc bộ nhớ đệm $0.00002 / 1K token Đầu vào · Ghi bộ nhớ đệm — / 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.0001 / 1K token Đầu ra · Token đầu ra $0.0004 / 1K token Đầu vào · Đọc bộ nhớ đệm $0.00002 / 1K token Đầu vào · Ghi bộ nhớ đệm — / 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-2.5-flash-lite: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-2.5-flash-lite:batch', 'google/gemini-2.5-flash-lite']: raise ValueError("body.model must be an exact documented caller or wire ID")\n return {"endpoint":"/v1/chat/completions", "model":"google/gemini-2.5-flash-lite: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-2.5-flash-lite:batch
Dùng các đường dẫn phương thức hiển thị ở trên.