{ "aboutHtml": "

openai/gpt-4.1-mini:batch là mục batch cho việc chữ độc lập. Ví dụ: trích cùng bộ trường từ nhiều hội thoại hỗ trợ được cấp, một kết quả mỗi hội thoại. Chọn khi thu kết quả trễ phù hợp thay vì cần trợ lý trả trực tiếp.

Gửi mảng requests nội tuyến tới /v1/batches, endpoint=/v1/chat/completions và custom_id duy nhất mỗi mục. Từng body có messages; completion_window nhận 24h. Tính theo số dư, từ chối tạo qua thuê bao. Input batch là chữ, không có workflow tải Files/input_file_id. Mô tả Mini rộng không là hứa độ trễ tương tác cho tuyến batch.

", "aboutText": "openai/gpt-4.1-mini:batch là mục batch cho việc chữ độc lập. Ví dụ: trích cùng bộ trường từ nhiều hội thoại hỗ trợ được cấp, một kết quả mỗi hội thoại. Chọn khi thu kết quả trễ phù hợp thay vì cần trợ lý trả trực tiếp. Gửi mảng requests nội tuyến tới /v1/batches, endpoint=/v1/chat/completions và custom_id duy nhất mỗi mục. Từng body có messages; completion_window nhận 24h. Tính theo số dư, từ chối tạo qua thuê bao. Input batch là chữ, không có workflow tải Files/input_file_id. Mô tả Mini rộng không là hứa độ trễ tương tác cho tuyến batch.", "editorialOverlay": { "copy_fields": { "about_html": "

openai/gpt-4.1-mini:batch là mục batch cho việc chữ độc lập. Ví dụ: trích cùng bộ trường từ nhiều hội thoại hỗ trợ được cấp, một kết quả mỗi hội thoại. Chọn khi thu kết quả trễ phù hợp thay vì cần trợ lý trả trực tiếp.

Gửi mảng requests nội tuyến tới /v1/batches, endpoint=/v1/chat/completions và custom_id duy nhất mỗi mục. Từng body có messages; completion_window nhận 24h. Tính theo số dư, từ chối tạo qua thuê bao. Input batch là chữ, không có workflow tải Files/input_file_id. Mô tả Mini rộng không là hứa độ trễ tương tác cho tuyến batch.

", "short_text": "Batch yêu cầu chữ độc lập, ghép bằng custom_id và cửa sổ hoàn tất 24h tùy chọn." }, "copy_sha256": "2c2185346fefefe2c3a0a3a240368382c8c4c0afb8cb041c4e61b3eda8c82b7b", "copy_source": { "locale": "vi", "pack_sha256": "0f56d90ba41881e1134accf82e57338f246f8753ca4c0cee929aaffada5d10e7", "record_model_id": "openai/gpt-4.1-mini:batch", "source_facts_sha256": "700b5e5f6f6dd40ee42bf946b9828610614b08184d43f05aae195f8628c9719a", "validation_sha256": "a2ac2f28056280fc0b2ea34a501bf156d5ce155406e57e708edf30bfdf6bfdc6" }, "html_sha256": "9cce676b81295f2d121880c750d27797cb6577b6d98ca886934aff091dc298c1", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "vi", "methods": [ { "html": "

O

OpenAI: GPT-4.1 Mini (batch)

OpenAI /openai/gpt-4.1-mini:batch

Bắt đầu

Batch yêu cầu chữ độc lập, ghép bằng custom_id và cửa sổ hoàn tất 24h tùy chọn.

Đầu vào được chấp nhận: Văn bản
Kết quả: Văn bản

Về mô hình

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.

openai/gpt-4.1-mini:batch là mục batch cho việc chữ độc lập. Ví dụ: trích cùng bộ trường từ nhiều hội thoại hỗ trợ được cấp, một kết quả mỗi hội thoại. Chọn khi thu kết quả trễ phù hợp thay vì cần trợ lý trả trực tiếp.

Gửi mảng requests nội tuyến tới /v1/batches, endpoint=/v1/chat/completions và custom_id duy nhất mỗi mục. Từng body có messages; completion_window nhận 24h. Tính theo số dư, từ chối tạo qua thuê bao. Input batch là chữ, không có workflow tải Files/input_file_id. Mô tả Mini rộng không là hứa độ trễ tương tác cho tuyến batch.

Có trên Ailoot · đầu vào & phương thức

Ailoot Ultra · Xử lý hàng loạt POST /v1/batches

Đầu vào: text
Đầu ra: text
Định dạng đầu ra: JSON nội tuyến tại results[].response.body

Trường	Loại	Yêu cầu	Giá trị & giới hạn	Mặc định
Trường`endpoint`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn /v1/chat/completions	Mặc định—
Trường`model`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn openai/gpt-4.1-mini:batch	Mặc định—
Trường`requests`	Loại`batch_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ường`requests[].custom_id`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn	Mặc định—
Trường`requests[].body.messages`	Loại`message[]`	Yêu cầuBắt buộc	Giá trị & giới hạn	Mặc định—
Trường`completion_window`	Loại`string`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn 24h	Mặc định—
Trường`provider`	Loại`object\|null`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn	Mặc định—
Trường`requests[].body.model`	Loại`string`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn openai/gpt-4.1-mini:batch, openai/gpt-4.1-mini	Mặc định—
Trường`provider.only`	Loại`string[]`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn openai	Mặc định—
Trường`provider.allow_fallbacks`	Loại`boolean\|null`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn false, null	Mặc định—

Tham số phương thức và vòng đời

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

Bảng giá

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.

Chế độ nhanh: Chưa chỉ định Khi chọn chế độ nhanh
Chế độ Flex: Chưa chỉ định Khi chọn chế độ flex
Mức độ suy luận tối đa: Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa
Giá lưu đệm tường minh: Chưa bật Khi yêu cầu lưu đệm tường minh

Mức phí Ailoot

Giá theo cấu hình

Đố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.0004 / 1K token Đầu ra · Token đầu ra $0.0016 / 1K token Đầu vào · Đọc bộ nhớ đệm $0.0001 / 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.0004 / 1K token Đầu ra · Token đầu ra $0.0016 / 1K token Đầu vào · Đọc bộ nhớ đệm $0.0001 / 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 →

Ví dụ yêu cầu

Ailoot Ultra · Xử lý hàng loạt

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-4.1-mini: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\n

import 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-4.1-mini:batch', 'openai/gpt-4.1-mini']: raise ValueError("body.model must be an exact documented caller or wire ID")\n    return {"endpoint":"/v1/chat/completions", "model":"openai/gpt-4.1-mini: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"))\n

import 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.\n

Nhận và lưu kết quả

Ailoot Ultra · Xử lý hàng loạt

JSON nội tuyến tại results[].response.body

GET /v1/batches/{operation_id}

Kiểm tra trạng thái tác vụ

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\n

Lưu tất cả kết quả đã hoàn tất

Lư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.

Nếu cần kiểm tra phản hồi gố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 phản hồi

Trường	Loại
Trường`results[].custom_id`	Loạistring
Trường`results[].response.body.choices[].message.content`	Loạistring\|null
Trường`results[].error`	Loạiobject\|null
Trường`usage`	Loạiobject\|null
Trường`id`	Loạistring
Trường`model`	Loạistring
Trường`endpoint`	Loạistring
Trường`status`	Loạistring
Trường`request_counts`	Loạiobject
Trường`results[].id`	Loạistring
Trường`results[].response.status_code`	Loạiinteger
Trường`results[].response.request_id`	Loạistring

Lỗi và bước tiếp theo

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.

Bí danh

Bí danh mô hình

Ailoot Ultra openai/gpt-4.1-mini:batch

Bí danh đường dẫn phương thức

Dùng các đường dẫn phương thức hiển thị ở trên.

ID gọi liên quan

openai/gpt-4.1-mini:batch

", "method_identity": { "effective_request_model_id": "openai/gpt-4.1-mini:batch", "fmt": "batches", "http": "POST", "path": "/v1/batches", "request_model_id": "openai/gpt-4.1-mini:batch", "route_label": "Ultra" }, "method_key": "Ultra|batches|/v1/batches|openai%2Fgpt-4.1-mini%3Abatch", "ordinal": 0, "rawMethod": { "available": null, "cache_read": 0.1, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Preserve full JSON and every result; provider real IDs are only read from actual returned responses.", "authentication": { "api_key_source": "AILOOT_API_KEY", "header": "Authorization: Bearer" }, "errors": [ { "code": null, "condition": "Cấ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.", "http_status": 400, "recovery": "Sửa các trường được chỉ ra trước khi gửi bất kỳ yêu cầu mới nào.", "type": "invalid_request_error" }, { "code": null, "condition": "Khóa API không hợp lệ.", "http_status": 401, "recovery": "Sử dụng khóa Ailoot đã được cấp quyền.", "type": "authentication_error" }, { "code": null, "condition": "Nhóm xử lý hàng loạt không khả dụng.", "http_status": 403, "recovery": "Kiểm tra quyền sử dụng của khóa/nhóm.", "type": "permission_error" }, { "code": null, "condition": "Xử 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.", "http_status": 422, "recovery": "Sử dụng nhóm đã được cấp quyền và tính phí từ số dư.", "type": "invalid_request_error" }, { "code": null, "condition": "Không thể báo giá cho dữ liệu đầu vào của lô.", "http_status": 422, "recovery": "Giữ 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.", "type": "price_unavailable" }, { "code": null, "condition": "Khoản dự trữ cho xử lý hàng loạt không khả dụng.", "http_status": 402, "recovery": "Khắ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.", "type": "billing_error" }, { "code": null, "condition": "Giá phương thức xử lý hàng loạt/đơn giá gốc không khả dụng.", "http_status": 503, "recovery": "Giữ lại phản hồi; không thay thế đơn giá.", "type": "price_unavailable" }, { "code": null, "condition": "Tuyến cụ thể tới nhà cung cấp không khả dụng.", "http_status": 503, "recovery": "Giữ lại phản hồi để sửa tuyến.", "type": "api_error" }, { "code": "result_pending_check", "condition": "Kết quả gốc cần được kiểm tra; X-Should-Retry:false.", "http_status": 503, "recovery": "Giữ 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.", "type": null }, { "code": "not_found", "condition": "Khô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.", "http_status": 404, "recovery": "Sử dụng đúng id gốc và cùng người dùng/khóa/nhóm.", "type": null } ], "example_body": { "endpoint": "/v1/chat/completions", "model": "openai/gpt-4.1-mini:batch", "requests": [ { "body": { "max_tokens": 16, "messages": [ { "content": "Hello!", "role": "user" } ] }, "custom_id": "req-0001" } ] }, "input_constraints": [ "Use the exact shown :batch model ID.", "Each custom_id must be nonempty and unique within the batch.", "Keep requests last in the serialized body; duplicate JSON keys are rejected.", "Each body.model is omitted or equals the exact batch caller or its documented base ID.", "Per-item provider, service_tier and input_type are outside this batch profile.", "stream is omitted or false.", "Supply text messages for this Chat batch profile; image/audio/file/video objects, hosted tools and cache-control fields are outside this profile.", "If body.model is present, use only the exact caller or wire ID listed here; no suffix conversion is needed.", "For google/ wire IDs, all items use an identical response_format." ], "outputs": { "all_results": "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.", "enclosing_family": "batch", "family": "text", "fields": [ { "name": "results[].custom_id", "type": "string" }, { "name": "results[].response.body.choices[].message.content", "type": "string|null" }, { "name": "results[].error", "type": "object|null" }, { "name": "usage", "type": "object|null" }, { "description": null, "name": "id", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "endpoint", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "request_counts", "type": "object" }, { "description": null, "name": "results[].id", "type": "string" }, { "description": null, "name": "results[].response.status_code", "type": "integer" }, { "description": null, "name": "results[].response.request_id", "type": "string" } ], "format": "JSON nội tuyến tại results[].response.body" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "/v1/chat/completions" ], "enum_known": true, "name": "endpoint", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "openai/gpt-4.1-mini:batch" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_items": 1, "name": "requests", "required": true, "type": "batch_item[]" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "requests[].custom_id", "required": true, "type": "string", "unique_within_batch": true }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "requests[].body.messages", "required": true, "type": "message[]" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "24h" ], "enum_known": true, "name": "completion_window", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "provider", "required": false, "type": "object|null" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "openai/gpt-4.1-mini:batch", "openai/gpt-4.1-mini" ], "enum_known": true, "name": "requests[].body.model", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ [ "openai" ] ], "enum_known": true, "name": "provider.only", "required": false, "type": "string[]" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, null ], "enum_known": true, "name": "provider.allow_fallbacks", "required": false, "type": "boolean|null" } ], "provider_policy": { "allow_fallbacks": false, "configured_only": [ "openai" ], "per_item_override": false, "when_omitted": "Current Source injects the exact persisted declaration before fresh submission." }, "request_schema": { "additionalProperties": false, "properties": { "completion_window": { "enum": [ "24h" ], "type": "string" }, "endpoint": { "enum": [ "/v1/chat/completions" ], "type": "string" }, "model": { "enum": [ "openai/gpt-4.1-mini:batch" ], "type": "string" }, "provider": { "additionalProperties": false, "properties": { "allow_fallbacks": { "enum": [ false, null ], "type": [ "boolean", "null" ] }, "only": { "enum": [ [ "openai" ] ], "items": { "enum": [ "openai" ], "type": "string" }, "maxItems": 1, "minItems": 1, "type": "array" } }, "type": [ "object", "null" ] }, "requests": { "items": { "additionalProperties": false, "properties": { "body": { "additionalProperties": true, "properties": { "max_tokens": { "minimum": 1, "type": "integer" }, "messages": { "items": { "properties": { "content": { "type": "string" }, "role": { "type": "string" } }, "required": [ "role", "content" ], "type": "object" }, "minItems": 1, "type": "array" }, "model": { "enum": [ "openai/gpt-4.1-mini:batch", "openai/gpt-4.1-mini" ], "type": "string" } }, "required": [ "messages" ], "type": "object" }, "custom_id": { "minLength": 1, "type": "string" } }, "required": [ "custom_id", "body" ], "type": "object" }, "minItems": 1, "type": "array" } }, "required": [ "endpoint", "model", "requests" ], "type": "object" }, "schema_template": { "endpoint": "/v1/chat/completions", "model": "openai/gpt-4.1-mini:batch", "requests": [ { "body": { "max_tokens": 16, "messages": [ { "content": "Hello!", "role": "user" } ] }, "custom_id": "req-0001" } ] }, "unsupported": [ "Files/input_file_id batch upload workflow", "active cancel route", "public batch list/delete/result-download route", "model-name-derived capability or weights equivalence" ] }, "input": { "content_type": "application/json", "file_material": "Bê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.", "material_types": [ "text" ], "optional_controls": [ "provider.only", "provider.allow_fallbacks", "completion_window" ], "representation": "requests[] nội tuyến; mỗi phần tử có custom_id và body", "request_endpoint_profile": "/v1/chat/completions", "required": [ "endpoint", "model", "requests" ], "schema_scope": "Phầ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.", "serialization_order": [ "endpoint", "model", "provider (nếu được cung cấp)", "completion_window (nếu được cung cấp)", "requests ở cuối" ] }, "lifecycle": { "cancel": null, "create": { "accepted_status": 202, "http": "POST", "path": "/v1/batches" }, "delete": null, "file_upload": null, "mode": "asynchronous", "observed_status_values": [ "validating", "in_progress", "finalizing", "completed", "failed", "expired", "cancelling", "cancelled" ], "owned_results": { "behavior": "Completed results are saved as owned JSONL, read back byte-for-byte and registered in the existing media library before publication after settlement. Status returns inline results; no separate Batch download route is added.", "format": "application/x-ndjson", "public_url_field_in_status": null }, "status": { "http": "GET", "id_source": "response.id thực tế từ phản hồi tạo gốc; cùng người dùng/khóa/nhóm", "path": "/v1/batches/{operation_id}" }, "terminal": [ "completed", "failed", "expired", "cancelled" ], "unknown": "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." }, "manufacturer_capability": null, "method": { "http": "POST", "path": "/v1/batches" }, "output": { "all_results": "Preserve the full original status JSON, every result/custom_id and complete response or error body. Save completed results[] as JSONL without filtering.", "family": "batch", "format": "JSON; completed results[] are returned inline and can be saved as JSONL." } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Giá cơ sở cho token", "units": [ { "amount": "0.0004000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.0000004", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.0016000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.0000016", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": "0.0001000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": "0.0000001", "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "max_context_tokens_inclusive": null, "min_context_tokens_exclusive": 0 }, "label": "Bậc 1 theo độ dài yêu cầu", "units": [ { "amount": "0.0004000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.0000004", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.0016000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.0000016", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": "0.0001000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": "0.0000001", "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] } ], "examples": [ { "code": "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-4.1-mini: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\n", "label": "curl · retained fixture", "language": "bash" }, { "code": "import 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-4.1-mini:batch', 'openai/gpt-4.1-mini']: raise ValueError(\"body.model must be an exact documented caller or wire ID\")\n return {\"endpoint\":\"/v1/chat/completions\", \"model\":\"openai/gpt-4.1-mini: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\"))\n", "label": "Python HTTP · actual customer JSONL", "language": "python" }, { "code": "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\n", "label": "curl · original operation status", "language": "bash" }, { "code": "import 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.\n", "label": "Python · save every completed result", "language": "python" } ], "family": "batch", "fast_multiplier": null, "flex_multiplier": null, "fmt": "batches", "hints": [ "Read your actual request items before submission; inline requests are required.", "Keep the returned operation ID and every result. Never replay an unknown submission." ], "http": "POST", "in": 0.4, "input": [ "text" ], "label": "Xử lý hàng loạt", "max_out": null, "max_reasoning_effort_multiplier": null, "out": 1.6, "output": [ "text" ], "path": "/v1/batches", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" }, { "label": "Explicit cache pricing", "value": "Not enabled", "when": "When explicit cache is requested" } ], "pricing": { "billing_mode": "token", "image_input_price": null, "image_output_price": null, "per_request_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": "0.0004000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.0000004", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.0016000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.0000016", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": "0.0001000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": "0.0000001", "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "max_context_tokens_inclusive": null, "min_context_tokens_exclusive": 0 }, "label": "Request-length tier 1", "units": [ { "amount": "0.0004000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.0000004", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.0016000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.0000016", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": "0.0001000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": "0.0000001", "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] } ], "request_model_id": "openai/gpt-4.1-mini:batch", "route_label": "Ultra", "status_reads": [ "GET /v1/batches/{operation_id}" ], "tiers": [ { "cache_read": 0.1, "cache_read_multiplier": null, "cache_write": null, "cache_write_1h": null, "cache_write_multiplier": null, "created_at": "0001-01-01T00:00:00Z", "in": 0.4, "input_multiplier": null, "max": null, "max_tokens": null, "min": 0, "min_tokens": 0, "out": 1.6, "output_multiplier": null, "per_request_price": null, "sort_order": 0, "tier_label": "", "updated_at": "0001-01-01T00:00:00Z" } ], "units": [ { "amount": "0.0004000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.0000004", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.0016000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.0000016", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": "0.0001000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": "0.0000001", "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] } } ], "model_id": "openai/gpt-4.1-mini:batch", "nativeProvenance": { "input_facts_canonical_sha256": "31bc7996b8574df836746ac7dc7a92165af200b3b0f1bd92dce0d2166457bf03", "input_html_sha256": "f6b28284f1aba6968ce29b1392c45dab3cdcb96671835e29b371998ca8ab8c62", "private_audit_sha256": "51060b3c2623dc1d392879d91fb05568db74ced35d972e404fd9f164a165b520", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/vi/openai-gpt-4-1-mini-u003a-batch/", "description": "Batch yêu cầu chữ độc lập, ghép bằng custom_id và cửa sổ hoàn tất 24h tùy chọn.", "locale": "vi", "md_url": "https://ailoot.ai/models/vi/openai-gpt-4-1-mini-u003a-batch/index.md", "title": "OpenAI: GPT-4.1 Mini (batch) — Ailoot", "url": "https://ailoot.ai/models/vi/openai-gpt-4-1-mini-u003a-batch/" }, "rawModel": { "about": "GPT-4.1 Mini là mô hình GPT-4.1 nhỏ hơn, nhanh hơn của OpenAI để tuân thủ chỉ dẫn và gọi công cụ. Mô hình nhận văn bản, hình ảnh và trả về văn bản, gồm Structured Outputs dựa trên lược đồ. Nhà sản xuất mô tả phản hồi độ trễ thấp không có bước suy luận riêng, khiến Mini hữu ích cho trợ lý tương tác hoặc bước được xác định rõ trong quy trình lớn hơn.\n\nVới trích xuất tài liệu, cung cấp tài liệu nguồn, đặt tên các trường cần trả về và giải thích cách thể hiện giá trị thiếu hoặc xung đột. Nhiệm vụ thực tế là chuyển tập tin nhắn hỗ trợ thành chủ đề, bản tóm tắt bằng chứng và câu trả lời đề xuất dựa trên chính sách liên quan. Với sửa mã, đưa vào tệp bị ảnh hưởng, thay đổi được yêu cầu và hành vi phải giữ nguyên. Những mô tả nhiệm vụ này cho mô hình sản phẩm cụ thể để tạo, thay vì chỉ dẫn mở phải phân tích mọi thứ.\n\nOpenAI nêu cửa sổ ngữ cảnh 1 047 576 token, tối đa 32 768 token đầu ra và mốc kiến thức ngày 1 tháng sáu năm 2024. Tài liệu nguồn, hội thoại và đầu ra được tạo dùng chung ngữ cảnh hiện có. Tổ chức đầu vào dài bằng ranh giới tài liệu, mã định danh, nêu câu hỏi quan trọng và chừa chỗ cho câu trả lời. Dữ kiện hiện tại hoặc riêng tư cần nằm trong tài liệu cung cấp hoặc kết quả từ công cụ truy xuất được cấu hình rõ.\n\nĐầu vào ảnh hỗ trợ câu hỏi về ảnh chụp, ảnh màn hình, sơ đồ hoặc trang tài liệu. Hướng dẫn thị giác của OpenAI chấp nhận PNG, JPEG, WebP và GIF không động. Bảng kích thước hiện tại của GPT-4.1 Mini hỗ trợ mức chi tiết low, high và auto với cùng kích thước chiều lớn nhất 2 048 pixel và ngân sách 6 144 mảnh ảnh khi đổi kích thước; mức original không được hỗ trợ. Phóng chữ nhỏ, giữ nhãn đúng chiều và bảo toàn ngữ cảnh hình ảnh cần để diễn giải biểu đồ. Quan hệ không gian chính xác, số vật thể và một số chữ viết không dùng ký tự Latinh có thể khó, nên yêu cầu quan sát liên quan và giữ ảnh để đối chiếu. Trong quy trình thị giác được OpenAI tài liệu hóa, tổng dữ liệu yêu cầu giới hạn 512 MB và mỗi yêu cầu có thể gồm tối đa 1 500 ảnh; ảnh và văn bản cũng phải vừa ngữ cảnh mô hình.\n\nQuy trình đầu vào tệp của nhà sản xuất phân biệt trang PDF với tài liệu khác. Với mô hình có khả năng thị giác, PDF cung cấp văn bản trích xuất và ảnh trang. Tài liệu không phải PDF cung cấp văn bản thay vì biểu đồ nhúng, còn xử lý bảng tính dùng tối đa 1 000 hàng đầu của mỗi trang tính trong biểu diễn bổ sung nhỏ hơn. Mỗi tệp phải dưới 50 MB, tổng dung lượng tệp cho mỗi yêu cầu không quá 50 MB. Chat Completions nhận phần tệp PDF; quy trình Responses còn nhận các định dạng văn bản, tài liệu văn phòng và bảng tính được tài liệu hóa. Chọn biểu diễn chứa bằng chứng câu hỏi cần.\n\nTruyền theo luồng có thể trả văn bản khi đang tạo. Với sản phẩm cuối máy đọc được, Structured Outputs ràng buộc câu trả lời hoàn chỉnh theo tập con JSON Schema được hỗ trợ, còn chế độ JSON chỉ xử lý tính hợp lệ của JSON. Xác định trường bắt buộc, kiểu, giá trị cho phép và biểu diễn rõ thông tin thiếu. Từ chối hoặc câu trả lời chưa hoàn chỉnh cần xử lý riêng, còn đối tượng đúng hình thức vẫn có thể chứa giá trị sai. Kết quả hữu ích là tập trường đầy đủ gắn với bằng chứng được cung cấp.\n\nBộ công cụ được tài liệu hóa của Mini gồm gọi hàm, tìm kiếm web, tìm kiếm tệp, trình thông dịch mã và kết nối MCP. Cung cấp mô tả rõ cùng lược đồ đối số cho công cụ tùy chỉnh; ứng dụng thực thi hàm được yêu cầu và trả quan sát thực tế cho bước mô hình tiếp theo. OpenAI cũng liệt kê Mini trong các mô hình có thể dùng công cụ tạo ảnh của hãng trong quy trình Responses được cấu hình. Công cụ đó tạo sản phẩm ảnh riêng; loại đầu ra được tài liệu hóa của chính Mini vẫn là văn bản. Kết quả truy xuất hoặc tính toán cần mang dữ kiện cần cho phần giải thích cuối.\n\nPredicted Outputs là cơ chế riêng của nhà sản xuất để tạo lại văn bản hoặc mã phần lớn đã biết với thay đổi nhỏ. Cung cấp nội dung có sẵn cùng chỉnh sửa cần thiết. Cơ chế đó chỉ dùng văn bản và không kết hợp gọi hàm; nó còn loại trừ một số thiết lập tạo thông thường, gồm max_completion_tokens và logprobs. Dùng yêu cầu thông thường có công cụ khi nhiệm vụ cần quan sát bên ngoài, thay vì coi dự đoán và thực thi công cụ có thể thay thế cho nhau.\n\nOpenAI tài liệu hóa tinh chỉnh có giám sát và tối ưu sở thích trực tiếp cho bản có tên cụ thể thuộc họ GPT-4.1 Mini. Đây là quy trình tùy biến mô hình: ví dụ có giám sát dạy hành vi đầu vào thành đầu ra mong muốn, còn câu trả lời được ưu tiên và bị loại thể hiện lựa chọn về phong cách hoặc nội dung. Với suy luận thông thường của mô hình, bắt đầu bằng nhiệm vụ rõ ràng, bằng chứng liên quan và một ví dụ kết quả cần có. Yêu cầu tiếp theo có phạm vi rõ có thể sửa trường, hoàn thiện câu trả lời đề xuất hoặc chỉnh cùng thay đổi mã, trong khi giữ các giới hạn ban đầu rõ ràng.", "alias_of": null, "aliases": [], "author": "OpenAI", "capabilities": { "context_length": 1047576, "manufacturer_input": [ "image", "text", "file" ], "manufacturer_output": [ "text" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.0004000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.0000004", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.0016000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.0000016", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" } ], "summary": "Giá theo cấu hình được trình bày đầy đủ trong phần chi tiết." } ], "ctx": null, "formats": [ "batches" ], "id": "openai/gpt-4.1-mini:batch", "input": [ "text" ], "kind": "text", "max_out": null, "methods": [ { "available": null, "cache_read": 0.1, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Preserve full JSON and every result; provider real IDs are only read from actual returned responses.", "authentication": { "api_key_source": "AILOOT_API_KEY", "header": "Authorization: Bearer" }, "errors": [ { "code": null, "condition": "Cấ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.", "http_status": 400, "recovery": "Sửa các trường được chỉ ra trước khi gửi bất kỳ yêu cầu mới nào.", "type": "invalid_request_error" }, { "code": null, "condition": "Khóa API không hợp lệ.", "http_status": 401, "recovery": "Sử dụng khóa Ailoot đã được cấp quyền.", "type": "authentication_error" }, { "code": null, "condition": "Nhóm xử lý hàng loạt không khả dụng.", "http_status": 403, "recovery": "Kiểm tra quyền sử dụng của khóa/nhóm.", "type": "permission_error" }, { "code": null, "condition": "Xử 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.", "http_status": 422, "recovery": "Sử dụng nhóm đã được cấp quyền và tính phí từ số dư.", "type": "invalid_request_error" }, { "code": null, "condition": "Không thể báo giá cho dữ liệu đầu vào của lô.", "http_status": 422, "recovery": "Giữ 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.", "type": "price_unavailable" }, { "code": null, "condition": "Khoản dự trữ cho xử lý hàng loạt không khả dụng.", "http_status": 402, "recovery": "Khắ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.", "type": "billing_error" }, { "code": null, "condition": "Giá phương thức xử lý hàng loạt/đơn giá gốc không khả dụng.", "http_status": 503, "recovery": "Giữ lại phản hồi; không thay thế đơn giá.", "type": "price_unavailable" }, { "code": null, "condition": "Tuyến cụ thể tới nhà cung cấp không khả dụng.", "http_status": 503, "recovery": "Giữ lại phản hồi để sửa tuyến.", "type": "api_error" }, { "code": "result_pending_check", "condition": "Kết quả gốc cần được kiểm tra; X-Should-Retry:false.", "http_status": 503, "recovery": "Giữ 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.", "type": null }, { "code": "not_found", "condition": "Khô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.", "http_status": 404, "recovery": "Sử dụng đúng id gốc và cùng người dùng/khóa/nhóm.", "type": null } ], "example_body": { "endpoint": "/v1/chat/completions", "model": "openai/gpt-4.1-mini:batch", "requests": [ { "body": { "max_tokens": 16, "messages": [ { "content": "Hello!", "role": "user" } ] }, "custom_id": "req-0001" } ] }, "input_constraints": [ "Use the exact shown :batch model ID.", "Each custom_id must be nonempty and unique within the batch.", "Keep requests last in the serialized body; duplicate JSON keys are rejected.", "Each body.model is omitted or equals the exact batch caller or its documented base ID.", "Per-item provider, service_tier and input_type are outside this batch profile.", "stream is omitted or false.", "Supply text messages for this Chat batch profile; image/audio/file/video objects, hosted tools and cache-control fields are outside this profile.", "If body.model is present, use only the exact caller or wire ID listed here; no suffix conversion is needed.", "For google/ wire IDs, all items use an identical response_format." ], "outputs": { "all_results": "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.", "enclosing_family": "batch", "family": "text", "fields": [ { "name": "results[].custom_id", "type": "string" }, { "name": "results[].response.body.choices[].message.content", "type": "string|null" }, { "name": "results[].error", "type": "object|null" }, { "name": "usage", "type": "object|null" }, { "description": null, "name": "id", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "endpoint", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "request_counts", "type": "object" }, { "description": null, "name": "results[].id", "type": "string" }, { "description": null, "name": "results[].response.status_code", "type": "integer" }, { "description": null, "name": "results[].response.request_id", "type": "string" } ], "format": "JSON nội tuyến tại results[].response.body" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "/v1/chat/completions" ], "enum_known": true, "name": "endpoint", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "openai/gpt-4.1-mini:batch" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_items": 1, "name": "requests", "required": true, "type": "batch_item[]" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "requests[].custom_id", "required": true, "type": "string", "unique_within_batch": true }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "requests[].body.messages", "required": true, "type": "message[]" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "24h" ], "enum_known": true, "name": "completion_window", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "provider", "required": false, "type": "object|null" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "openai/gpt-4.1-mini:batch", "openai/gpt-4.1-mini" ], "enum_known": true, "name": "requests[].body.model", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ [ "openai" ] ], "enum_known": true, "name": "provider.only", "required": false, "type": "string[]" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, null ], "enum_known": true, "name": "provider.allow_fallbacks", "required": false, "type": "boolean|null" } ], "provider_policy": { "allow_fallbacks": false, "configured_only": [ "openai" ], "per_item_override": false, "when_omitted": "Current Source injects the exact persisted declaration before fresh submission." }, "request_schema": { "additionalProperties": false, "properties": { "completion_window": { "enum": [ "24h" ], "type": "string" }, "endpoint": { "enum": [ "/v1/chat/completions" ], "type": "string" }, "model": { "enum": [ "openai/gpt-4.1-mini:batch" ], "type": "string" }, "provider": { "additionalProperties": false, "properties": { "allow_fallbacks": { "enum": [ false, null ], "type": [ "boolean", "null" ] }, "only": { "enum": [ [ "openai" ] ], "items": { "enum": [ "openai" ], "type": "string" }, "maxItems": 1, "minItems": 1, "type": "array" } }, "type": [ "object", "null" ] }, "requests": { "items": { "additionalProperties": false, "properties": { "body": { "additionalProperties": true, "properties": { "max_tokens": { "minimum": 1, "type": "integer" }, "messages": { "items": { "properties": { "content": { "type": "string" }, "role": { "type": "string" } }, "required": [ "role", "content" ], "type": "object" }, "minItems": 1, "type": "array" }, "model": { "enum": [ "openai/gpt-4.1-mini:batch", "openai/gpt-4.1-mini" ], "type": "string" } }, "required": [ "messages" ], "type": "object" }, "custom_id": { "minLength": 1, "type": "string" } }, "required": [ "custom_id", "body" ], "type": "object" }, "minItems": 1, "type": "array" } }, "required": [ "endpoint", "model", "requests" ], "type": "object" }, "schema_template": { "endpoint": "/v1/chat/completions", "model": "openai/gpt-4.1-mini:batch", "requests": [ { "body": { "max_tokens": 16, "messages": [ { "content": "Hello!", "role": "user" } ] }, "custom_id": "req-0001" } ] }, "unsupported": [ "Files/input_file_id batch upload workflow", "active cancel route", "public batch list/delete/result-download route", "model-name-derived capability or weights equivalence" ] }, "input": { "content_type": "application/json", "file_material": "Bê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.", "material_types": [ "text" ], "optional_controls": [ "provider.only", "provider.allow_fallbacks", "completion_window" ], "representation": "requests[] nội tuyến; mỗi phần tử có custom_id và body", "request_endpoint_profile": "/v1/chat/completions", "required": [ "endpoint", "model", "requests" ], "schema_scope": "Phầ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.", "serialization_order": [ "endpoint", "model", "provider (nếu được cung cấp)", "completion_window (nếu được cung cấp)", "requests ở cuối" ] }, "lifecycle": { "cancel": null, "create": { "accepted_status": 202, "http": "POST", "path": "/v1/batches" }, "delete": null, "file_upload": null, "mode": "asynchronous", "observed_status_values": [ "validating", "in_progress", "finalizing", "completed", "failed", "expired", "cancelling", "cancelled" ], "owned_results": { "behavior": "Completed results are saved as owned JSONL, read back byte-for-byte and registered in the existing media library before publication after settlement. Status returns inline results; no separate Batch download route is added.", "format": "application/x-ndjson", "public_url_field_in_status": null }, "status": { "http": "GET", "id_source": "response.id thực tế từ phản hồi tạo gốc; cùng người dùng/khóa/nhóm", "path": "/v1/batches/{operation_id}" }, "terminal": [ "completed", "failed", "expired", "cancelled" ], "unknown": "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." }, "manufacturer_capability": null, "method": { "http": "POST", "path": "/v1/batches" }, "output": { "all_results": "Preserve the full original status JSON, every result/custom_id and complete response or error body. Save completed results[] as JSONL without filtering.", "family": "batch", "format": "JSON; completed results[] are returned inline and can be saved as JSONL." } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Giá cơ sở cho token", "units": [ { "amount": "0.0004000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.0000004", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.0016000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.0000016", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": "0.0001000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": "0.0000001", "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "max_context_tokens_inclusive": null, "min_context_tokens_exclusive": 0 }, "label": "Bậc 1 theo độ dài yêu cầu", "units": [ { "amount": "0.0004000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.0000004", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.0016000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.0000016", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": "0.0001000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": "0.0000001", "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] } ], "examples": [ { "code": "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-4.1-mini: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\n", "label": "curl · retained fixture", "language": "bash" }, { "code": "import 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-4.1-mini:batch', 'openai/gpt-4.1-mini']: raise ValueError(\"body.model must be an exact documented caller or wire ID\")\n return {\"endpoint\":\"/v1/chat/completions\", \"model\":\"openai/gpt-4.1-mini: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\"))\n", "label": "Python HTTP · actual customer JSONL", "language": "python" }, { "code": "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\n", "label": "curl · original operation status", "language": "bash" }, { "code": "import 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.\n", "label": "Python · save every completed result", "language": "python" } ], "family": "batch", "fast_multiplier": null, "flex_multiplier": null, "fmt": "batches", "hints": [ "Read your actual request items before submission; inline requests are required.", "Keep the returned operation ID and every result. Never replay an unknown submission." ], "http": "POST", "in": 0.4, "input": [ "text" ], "label": "Xử lý hàng loạt", "max_out": null, "max_reasoning_effort_multiplier": null, "out": 1.6, "output": [ "text" ], "path": "/v1/batches", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" }, { "label": "Explicit cache pricing", "value": "Not enabled", "when": "When explicit cache is requested" } ], "pricing": { "billing_mode": "token", "image_input_price": null, "image_output_price": null, "per_request_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": "0.0004000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.0000004", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.0016000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.0000016", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": "0.0001000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": "0.0000001", "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "max_context_tokens_inclusive": null, "min_context_tokens_exclusive": 0 }, "label": "Request-length tier 1", "units": [ { "amount": "0.0004000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.0000004", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.0016000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.0000016", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": "0.0001000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": "0.0000001", "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] } ], "request_model_id": "openai/gpt-4.1-mini:batch", "route_label": "Ultra", "status_reads": [ "GET /v1/batches/{operation_id}" ], "tiers": [ { "cache_read": 0.1, "cache_read_multiplier": null, "cache_write": null, "cache_write_1h": null, "cache_write_multiplier": null, "created_at": "0001-01-01T00:00:00Z", "in": 0.4, "input_multiplier": null, "max": null, "max_tokens": null, "min": 0, "min_tokens": 0, "out": 1.6, "output_multiplier": null, "per_request_price": null, "sort_order": 0, "tier_label": "", "updated_at": "0001-01-01T00:00:00Z" } ], "units": [ { "amount": "0.0004000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.0000004", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.0016000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.0000016", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": "0.0001000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": "0.0000001", "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] } ], "model_aliases": [ { "canonical_model_id": "openai/gpt-4.1-mini:batch", "request_model_id": "openai/gpt-4.1-mini:batch", "route_label": "Ultra" } ], "name": "OpenAI: GPT-4.1 Mini (batch)", "price": { "in": 0.4, "in_label": null, "out": 1.6, "out_label": null, "scope_label": "Token rates", "sort_in": 0.4, "sort_out": 1.6, "varies": true }, "short": "GPT-4.1 Mini kết hợp hiểu văn bản và hình ảnh với ngữ cảnh lớn, chỉ dẫn chính xác và gọi công cụ. Dùng mô hình để trích xuất thông tin có cấu trúc, trả lời từ tài liệu được cung cấp hoặc thực hiện nhiệm vụ viết, lập trình có phạm vi rõ ràng." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "Batch yêu cầu chữ độc lập, ghép bằng custom_id và cửa sổ hoàn tất 24h tùy chọn.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "2ec4a138e804dbcc9608f896bdcc4fec7eeb040b676caaa77c1d919d0f078215", "renderer_sha256": "64a62299639eb843877e9ec5c95e32bf22bac3acfe230f6f502c5c3aa186f9c1" }, "sourceRevision": "4fd434f5e2e9ef2c07267ccd45cbb9697d3db2f865db2e4f312acf4c6a0831e8" }