GPT-5.5 là mô hình suy luận chủ lực của OpenAI dành cho công việc chuyên môn phức tạp và lập trình. Mô hình nhận văn bản, hình ảnh và trả về văn bản, kết hợp phân tích với công cụ khi nhiệm vụ cần thông tin hoặc hành động ngoài prompt đã cung cấp. Hướng dẫn của OpenAI nhấn mạnh làm việc từ kết quả rõ ràng: giải thích kết quả cần có, ràng buộc phải giữ, bằng chứng cần dùng và điều kiện kết thúc nhiệm vụ.
Với thay đổi phần mềm đáng kể, cung cấp tài liệu kho mã liên quan, hành vi hiện tại, hành vi mong muốn và tiêu chí chấp nhận. Xác định điều có thể thay đổi và điều phải giữ tương thích. Kết quả được yêu cầu hữu ích là thay đổi đề xuất, lời giải thích về hành vi chịu ảnh hưởng và bằng chứng từ kiểm tra thực sự đã chạy. Với nhiệm vụ nhiều tài liệu, gắn nhãn các tài liệu nguồn và yêu cầu câu trả lời tổ chức quanh quyết định cần đưa ra, gắn từng kết luận với bằng chứng được cung cấp và tách câu hỏi chưa giải quyết khỏi dữ kiện đã xác lập.
GPT-5.5 hỗ trợ các mức suy luận none, low, medium, high và xhigh, mặc định là medium. OpenAI khuyến nghị cân nhắc low trước none khi quy trình cần phản hồi nhanh vẫn cần lập kế hoạch, tìm kiếm hoặc nhiều lần gọi công cụ. None phù hợp với nhiệm vụ trực tiếp không cần quá trình suy luận đó. Mức cao hơn không tự động tốt hơn: yêu cầu mâu thuẫn, quyền dùng công cụ không giới hạn hoặc quy tắc dừng không rõ có thể dẫn đến tìm kiếm không cần thiết và suy nghĩ quá mức. Chọn mức phù hợp với nhiệm vụ thực tế và nêu rõ sản phẩm cuối cùng cùng tiêu chí hoàn tất được mong đợi.
Nhà sản xuất liệt kê cửa sổ ngữ cảnh 1,050,000 token và đầu ra tối đa 128,000 token, với mốc kiến thức ngày 1 tháng Mười Hai năm 2025. Ngữ cảnh chứa hội thoại, tài liệu được cung cấp và nội dung được tạo; đó không phải dung lượng riêng để cộng vào đầu ra tối đa. Suy luận nội bộ cũng dùng token và dung lượng đầu ra. Vì vậy, tập nguồn lớn cần được tổ chức quanh câu hỏi, giữ mã định danh, đơn vị và ranh giới tài liệu quan trọng, đồng thời chừa đủ chỗ cho suy luận và câu trả lời cuối cùng.
Xử lý hình ảnh khác với các mặc định trước đây. Trong hướng dẫn GPT-5.5 của OpenAI, thiết lập chi tiết hình ảnh không được đặt hoặc được đặt là auto dùng hành vi original, giữ nguyên hình ảnh không đổi kích thước khi đáp ứng cả ngân sách 10,240,000 pixel lẫn kích thước tối đa 6,000 pixel đã nêu. Thiết lập high được chọn tường minh giữ chi tiết trong cả ngân sách 2,500,000 pixel lẫn kích thước tối đa 2,048 pixel đã nêu; low thu nhỏ mạnh hơn các hình ảnh vượt kích thước 512 pixel. Đây là các thiết lập xử lý hình ảnh, không bảo đảm mọi tệp tải lên đều được chấp nhận. Với ảnh chụp màn hình, sơ đồ hoặc trang tài liệu, xác định vùng và câu hỏi, cung cấp hình ảnh dễ đọc và yêu cầu quan sát hoặc diễn giải cần có thay vì mô tả không giới hạn.
OpenAI tài liệu hóa các giao diện Responses, Chat Completions và Batch, với truyền phát, Structured Outputs, gọi hàm, tải tệp lên, đầu vào hình ảnh, tìm kiếm tệp và web, cùng bộ nhớ đệm prompt. Bộ công cụ được tài liệu hóa cũng gồm tìm kiếm công cụ, tạo hình ảnh, thông dịch mã, shell trong môi trường do nhà cung cấp vận hành, thao tác áp dụng bản vá, kỹ năng, thao tác máy tính và MCP. Mô tả mục đích, đối số, tác động phụ và thông tin trả về của từng công cụ ứng dụng. Yêu cầu gọi hàm ứng dụng cần ứng dụng thực thi thao tác đó và trả về kết quả thực tế; đề xuất hành động được tạo không phải bằng chứng hành động đã xảy ra. Phương thức đầu ra của chính mô hình vẫn là văn bản, còn công cụ tạo hình ảnh có thể tạo sản phẩm riêng.
Với tương tác dài hơn, giữ thông tin cần để phân biệt công việc trung gian với câu trả lời đã hoàn tất. Hướng dẫn của OpenAI mô tả các giá trị phase của trợ lý commentary và final cho phần bình luận và câu trả lời cuối cùng: ứng dụng tự phát lại các mục trợ lý phải giữ nguyên giá trị phase ban đầu, còn nối chuỗi qua cơ chế phản hồi trước của nhà sản xuất tự động giữ trạng thái đó. Với câu trả lời hiển thị, xác định rõ độ dài, giọng điệu và cấu trúc mong muốn. GPT-5.5 mặc định có phong cách ngắn gọn, trực tiếp; độ chi tiết văn bản mặc định là medium. Kết quả gọn có thể yêu cầu độ chi tiết thấp hơn mà không bỏ bằng chứng hoặc điều kiện bắt buộc.
Sản phẩm cuối cùng hữu ích có thể là tệp được sửa kèm giải thích thay đổi có trọng tâm, bản ghi nhớ quyết định dựa trên tài liệu có tên hoặc kết quả trích xuất có cấu trúc đánh dấu rõ giá trị thiếu. Cung cấp dữ kiện cần cập nhật thay vì dựa vào mốc kiến thức của mô hình và so sánh phát biểu quan trọng với tài liệu gốc. Quy tắc bằng chứng rõ ràng, công cụ có giới hạn và điều kiện dừng tường minh giúp GPT-5.5 hoàn tất nhiệm vụ đáng kể, giữ kết quả dễ hiểu và có thể rà soát.
", "aboutText": "GPT-5.5 là mô hình suy luận chủ lực của OpenAI dành cho công việc chuyên môn phức tạp và lập trình. Mô hình nhận văn bản, hình ảnh và trả về văn bản, kết hợp phân tích với công cụ khi nhiệm vụ cần thông tin hoặc hành động ngoài prompt đã cung cấp. Hướng dẫn của OpenAI nhấn mạnh làm việc từ kết quả rõ ràng: giải thích kết quả cần có, ràng buộc phải giữ, bằng chứng cần dùng và điều kiện kết thúc nhiệm vụ.\n\nVới thay đổi phần mềm đáng kể, cung cấp tài liệu kho mã liên quan, hành vi hiện tại, hành vi mong muốn và tiêu chí chấp nhận. Xác định điều có thể thay đổi và điều phải giữ tương thích. Kết quả được yêu cầu hữu ích là thay đổi đề xuất, lời giải thích về hành vi chịu ảnh hưởng và bằng chứng từ kiểm tra thực sự đã chạy. Với nhiệm vụ nhiều tài liệu, gắn nhãn các tài liệu nguồn và yêu cầu câu trả lời tổ chức quanh quyết định cần đưa ra, gắn từng kết luận với bằng chứng được cung cấp và tách câu hỏi chưa giải quyết khỏi dữ kiện đã xác lập.\n\nGPT-5.5 hỗ trợ các mức suy luận none, low, medium, high và xhigh, mặc định là medium. OpenAI khuyến nghị cân nhắc low trước none khi quy trình cần phản hồi nhanh vẫn cần lập kế hoạch, tìm kiếm hoặc nhiều lần gọi công cụ. None phù hợp với nhiệm vụ trực tiếp không cần quá trình suy luận đó. Mức cao hơn không tự động tốt hơn: yêu cầu mâu thuẫn, quyền dùng công cụ không giới hạn hoặc quy tắc dừng không rõ có thể dẫn đến tìm kiếm không cần thiết và suy nghĩ quá mức. Chọn mức phù hợp với nhiệm vụ thực tế và nêu rõ sản phẩm cuối cùng cùng tiêu chí hoàn tất được mong đợi.\n\nNhà sản xuất liệt kê cửa sổ ngữ cảnh 1,050,000 token và đầu ra tối đa 128,000 token, với mốc kiến thức ngày 1 tháng Mười Hai năm 2025. Ngữ cảnh chứa hội thoại, tài liệu được cung cấp và nội dung được tạo; đó không phải dung lượng riêng để cộng vào đầu ra tối đa. Suy luận nội bộ cũng dùng token và dung lượng đầu ra. Vì vậy, tập nguồn lớn cần được tổ chức quanh câu hỏi, giữ mã định danh, đơn vị và ranh giới tài liệu quan trọng, đồng thời chừa đủ chỗ cho suy luận và câu trả lời cuối cùng.\n\nXử lý hình ảnh khác với các mặc định trước đây. Trong hướng dẫn GPT-5.5 của OpenAI, thiết lập chi tiết hình ảnh không được đặt hoặc được đặt là auto dùng hành vi original, giữ nguyên hình ảnh không đổi kích thước khi đáp ứng cả ngân sách 10,240,000 pixel lẫn kích thước tối đa 6,000 pixel đã nêu. Thiết lập high được chọn tường minh giữ chi tiết trong cả ngân sách 2,500,000 pixel lẫn kích thước tối đa 2,048 pixel đã nêu; low thu nhỏ mạnh hơn các hình ảnh vượt kích thước 512 pixel. Đây là các thiết lập xử lý hình ảnh, không bảo đảm mọi tệp tải lên đều được chấp nhận. Với ảnh chụp màn hình, sơ đồ hoặc trang tài liệu, xác định vùng và câu hỏi, cung cấp hình ảnh dễ đọc và yêu cầu quan sát hoặc diễn giải cần có thay vì mô tả không giới hạn.\n\nOpenAI tài liệu hóa các giao diện Responses, Chat Completions và Batch, với truyền phát, Structured Outputs, gọi hàm, tải tệp lên, đầu vào hình ảnh, tìm kiếm tệp và web, cùng bộ nhớ đệm prompt. Bộ công cụ được tài liệu hóa cũng gồm tìm kiếm công cụ, tạo hình ảnh, thông dịch mã, shell trong môi trường do nhà cung cấp vận hành, thao tác áp dụng bản vá, kỹ năng, thao tác máy tính và MCP. Mô tả mục đích, đối số, tác động phụ và thông tin trả về của từng công cụ ứng dụng. Yêu cầu gọi hàm ứng dụng cần ứng dụng thực thi thao tác đó và trả về kết quả thực tế; đề xuất hành động được tạo không phải bằng chứng hành động đã xảy ra. Phương thức đầu ra của chính mô hình vẫn là văn bản, còn công cụ tạo hình ảnh có thể tạo sản phẩm riêng.\n\nVới tương tác dài hơn, giữ thông tin cần để phân biệt công việc trung gian với câu trả lời đã hoàn tất. Hướng dẫn của OpenAI mô tả các giá trị phase của trợ lý commentary và final cho phần bình luận và câu trả lời cuối cùng: ứng dụng tự phát lại các mục trợ lý phải giữ nguyên giá trị phase ban đầu, còn nối chuỗi qua cơ chế phản hồi trước của nhà sản xuất tự động giữ trạng thái đó. Với câu trả lời hiển thị, xác định rõ độ dài, giọng điệu và cấu trúc mong muốn. GPT-5.5 mặc định có phong cách ngắn gọn, trực tiếp; độ chi tiết văn bản mặc định là medium. Kết quả gọn có thể yêu cầu độ chi tiết thấp hơn mà không bỏ bằng chứng hoặc điều kiện bắt buộc.\n\nSản phẩm cuối cùng hữu ích có thể là tệp được sửa kèm giải thích thay đổi có trọng tâm, bản ghi nhớ quyết định dựa trên tài liệu có tên hoặc kết quả trích xuất có cấu trúc đánh dấu rõ giá trị thiếu. Cung cấp dữ kiện cần cập nhật thay vì dựa vào mốc kiến thức của mô hình và so sánh phát biểu quan trọng với tài liệu gốc. Quy tắc bằng chứng rõ ràng, công cụ có giới hạn và điều kiện dừng tường minh giúp GPT-5.5 hoàn tất nhiệm vụ đáng kể, giữ kết quả dễ hiểu và có thể rà soát.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "1b2bfea21db6002ef44be5a19343524cd1b2d2678cae14cad6df2aba132c718d", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "vi", "methods": [ { "html": "openai/gpt-5.5:batchGPT-5.5 của OpenAI xử lý công việc chuyên môn phức tạp và lập trình bằng đầu vào văn bản, hình ảnh, suy luận có thể cấu hình và bộ công cụ rộng. Ngữ cảnh lớn hỗ trợ làm việc với tài liệu nguồn đáng kể và trả về kết quả văn bản rõ ràng, dành riêng cho nhiệm vụ.
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.
GPT-5.5 là mô hình suy luận chủ lực của OpenAI dành cho công việc chuyên môn phức tạp và lập trình. Mô hình nhận văn bản, hình ảnh và trả về văn bản, kết hợp phân tích với công cụ khi nhiệm vụ cần thông tin hoặc hành động ngoài prompt đã cung cấp. Hướng dẫn của OpenAI nhấn mạnh làm việc từ kết quả rõ ràng: giải thích kết quả cần có, ràng buộc phải giữ, bằng chứng cần dùng và điều kiện kết thúc nhiệm vụ.
Với thay đổi phần mềm đáng kể, cung cấp tài liệu kho mã liên quan, hành vi hiện tại, hành vi mong muốn và tiêu chí chấp nhận. Xác định điều có thể thay đổi và điều phải giữ tương thích. Kết quả được yêu cầu hữu ích là thay đổi đề xuất, lời giải thích về hành vi chịu ảnh hưởng và bằng chứng từ kiểm tra thực sự đã chạy. Với nhiệm vụ nhiều tài liệu, gắn nhãn các tài liệu nguồn và yêu cầu câu trả lời tổ chức quanh quyết định cần đưa ra, gắn từng kết luận với bằng chứng được cung cấp và tách câu hỏi chưa giải quyết khỏi dữ kiện đã xác lập.
GPT-5.5 hỗ trợ các mức suy luận none, low, medium, high và xhigh, mặc định là medium. OpenAI khuyến nghị cân nhắc low trước none khi quy trình cần phản hồi nhanh vẫn cần lập kế hoạch, tìm kiếm hoặc nhiều lần gọi công cụ. None phù hợp với nhiệm vụ trực tiếp không cần quá trình suy luận đó. Mức cao hơn không tự động tốt hơn: yêu cầu mâu thuẫn, quyền dùng công cụ không giới hạn hoặc quy tắc dừng không rõ có thể dẫn đến tìm kiếm không cần thiết và suy nghĩ quá mức. Chọn mức phù hợp với nhiệm vụ thực tế và nêu rõ sản phẩm cuối cùng cùng tiêu chí hoàn tất được mong đợi.
Nhà sản xuất liệt kê cửa sổ ngữ cảnh 1,050,000 token và đầu ra tối đa 128,000 token, với mốc kiến thức ngày 1 tháng Mười Hai năm 2025. Ngữ cảnh chứa hội thoại, tài liệu được cung cấp và nội dung được tạo; đó không phải dung lượng riêng để cộng vào đầu ra tối đa. Suy luận nội bộ cũng dùng token và dung lượng đầu ra. Vì vậy, tập nguồn lớn cần được tổ chức quanh câu hỏi, giữ mã định danh, đơn vị và ranh giới tài liệu quan trọng, đồng thời chừa đủ chỗ cho suy luận và câu trả lời cuối cùng.
Xử lý hình ảnh khác với các mặc định trước đây. Trong hướng dẫn GPT-5.5 của OpenAI, thiết lập chi tiết hình ảnh không được đặt hoặc được đặt là auto dùng hành vi original, giữ nguyên hình ảnh không đổi kích thước khi đáp ứng cả ngân sách 10,240,000 pixel lẫn kích thước tối đa 6,000 pixel đã nêu. Thiết lập high được chọn tường minh giữ chi tiết trong cả ngân sách 2,500,000 pixel lẫn kích thước tối đa 2,048 pixel đã nêu; low thu nhỏ mạnh hơn các hình ảnh vượt kích thước 512 pixel. Đây là các thiết lập xử lý hình ảnh, không bảo đảm mọi tệp tải lên đều được chấp nhận. Với ảnh chụp màn hình, sơ đồ hoặc trang tài liệu, xác định vùng và câu hỏi, cung cấp hình ảnh dễ đọc và yêu cầu quan sát hoặc diễn giải cần có thay vì mô tả không giới hạn.
OpenAI tài liệu hóa các giao diện Responses, Chat Completions và Batch, với truyền phát, Structured Outputs, gọi hàm, tải tệp lên, đầu vào hình ảnh, tìm kiếm tệp và web, cùng bộ nhớ đệm prompt. Bộ công cụ được tài liệu hóa cũng gồm tìm kiếm công cụ, tạo hình ảnh, thông dịch mã, shell trong môi trường do nhà cung cấp vận hành, thao tác áp dụng bản vá, kỹ năng, thao tác máy tính và MCP. Mô tả mục đích, đối số, tác động phụ và thông tin trả về của từng công cụ ứng dụng. Yêu cầu gọi hàm ứng dụng cần ứng dụng thực thi thao tác đó và trả về kết quả thực tế; đề xuất hành động được tạo không phải bằng chứng hành động đã xảy ra. Phương thức đầu ra của chính mô hình vẫn là văn bản, còn công cụ tạo hình ảnh có thể tạo sản phẩm riêng.
Với tương tác dài hơn, giữ thông tin cần để phân biệt công việc trung gian với câu trả lời đã hoàn tất. Hướng dẫn của OpenAI mô tả các giá trị phase của trợ lý commentary và final cho phần bình luận và câu trả lời cuối cùng: ứng dụng tự phát lại các mục trợ lý phải giữ nguyên giá trị phase ban đầu, còn nối chuỗi qua cơ chế phản hồi trước của nhà sản xuất tự động giữ trạng thái đó. Với câu trả lời hiển thị, xác định rõ độ dài, giọng điệu và cấu trúc mong muốn. GPT-5.5 mặc định có phong cách ngắn gọn, trực tiếp; độ chi tiết văn bản mặc định là medium. Kết quả gọn có thể yêu cầu độ chi tiết thấp hơn mà không bỏ bằng chứng hoặc điều kiện bắt buộc.
Sản phẩm cuối cùng hữu ích có thể là tệp được sửa kèm giải thích thay đổi có trọng tâm, bản ghi nhớ quyết định dựa trên tài liệu có tên hoặc kết quả trích xuất có cấu trúc đánh dấu rõ giá trị thiếu. Cung cấp dữ kiện cần cập nhật thay vì dựa vào mốc kiến thức của mô hình và so sánh phát biểu quan trọng với tài liệu gốc. Quy tắc bằng chứng rõ ràng, công cụ có giới hạn và điều kiện dừng tường minh giúp GPT-5.5 hoàn tất nhiệm vụ đáng kể, giữ kết quả dễ hiểu và có thể rà soát.
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 openai/gpt-5.5: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 openai/gpt-5.5:batch, openai/gpt-5.5 | Mặc định— |
Trườngprovider.only | Loạistring[] | Yêu cầuKhông bắt buộc | Giá trị & giới hạn openai | 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.005 / 1K token Đầu ra · Token đầu ra $0.03 / 1K token Đầu vào · Đọc bộ nhớ đệm $0.0005 / 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ồm272.000 | Phí Đầu vào · Token đầu vào $0.005 / 1K token Đầu ra · Token đầu ra $0.03 / 1K token Đầu vào · Đọc bộ nhớ đệm $0.0005 / 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 2 theo độ dài yêu cầu | Biểu mức phí— | Token ngữ cảnh, lớn hơn272.000 | 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.01 / 1K token Đầu ra · Token đầu ra $0.045 / 1K token Đầu vào · Đọc bộ nhớ đệm $0.001 / 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":"openai/gpt-5.5: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 ['openai/gpt-5.5:batch', 'openai/gpt-5.5']: raise ValueError("body.model must be an exact documented caller or wire ID")\n return {"endpoint":"/v1/chat/completions", "model":"openai/gpt-5.5: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 openai/gpt-5.5:batch
Dùng các đường dẫn phương thức hiển thị ở trên.