GPT Image 2.5 Flare là phiên bản tạo và chỉnh sửa hình ảnh của OpenAI hướng tới công việc hằng ngày nhanh, chất lượng cao. Mô hình nhận văn bản và hình ảnh, trả về kết quả hình ảnh. Dùng cho bản phác thảo, minh họa, ý tưởng sản phẩm và nhiệm vụ sáng tạo định kỳ cần nhanh chóng biến bản yêu cầu thành ảnh sử dụng được. Flare tách biệt với Sunburst, vốn chú trọng độ chính xác chỉnh sửa. Chọn Flare cho tạo ảnh thường ngày và Sunburst khi ưu tiên sửa chính xác.
Bắt đầu với chủ thể chính, hành động, môi trường, bố cục và cách thể hiện hình ảnh. Với minh họa chiến dịch, yêu cầu người đi xe đạp qua cầu nhỏ trong ánh chiều ấm, hình dáng nổi bật và bầu trời thoáng cho chữ thêm sau. Bản yêu cầu khám phá ngắn có thể để mở lựa chọn thẩm mỹ; bản yêu cầu sản xuất cần nêu chi tiết và vị trí quan trọng. Quy trình tạo và sửa trực tiếp cho phép lời nhắc tối đa 32,000 ký tự và từ một đến mười kết quả, hữu ích để so sánh vài biến thể theo cùng mục đích.
Khi chỉnh sửa, có thể cung cấp tối đa mười sáu ảnh tham chiếu. Gán vai trò rõ cho mỗi ảnh thay vì mong mô hình tự quyết ảnh thể hiện danh tính chủ thể, cảnh vật hay phong cách. Mặt nạ có thể hướng dẫn sửa một vùng; với nhiều ảnh, nó áp dụng cho ảnh đầu tiên. Ảnh và mặt nạ phải cùng định dạng, kích thước, và mặt nạ phải chứa kênh alpha. Hướng dẫn yêu cầu nguồn và mặt nạ dưới 50 MB. Mặt nạ là chỉ dẫn chứ không cam kết giữ chính xác ranh giới, nên nêu cả thay đổi mong muốn và điều cần giữ dễ nhận ra.
Flare hỗ trợ chất lượng low, medium, high, xhigh, max và tự động, mặc định auto. Chất lượng thấp hơn có thể phục vụ phác thảo nhanh; có thể so sánh các mức cao hơn cho chi tiết của tài nguyên cuối. Chất lượng độc lập với kích thước và nén đầu ra. Kích thước chuẩn gồm 1024 × 1024, 1536 × 1024 và 1024 × 1536, đồng thời có kích thước tự động hoặc tùy chỉnh. Chọn hướng khung theo vị trí cuối và không gian hữu ích của cảnh.
Chiều rộng, chiều cao tùy chỉnh phải là bội số của mười sáu, không cạnh nào trên 3840 pixel. Tỷ lệ cho phép từ 1:3 đến 3:1, và tổng diện tích ít nhất 655,360, nhiều nhất 8,294,400 pixel. Cả bốn điều kiện áp dụng đồng thời. Hướng dẫn xác định độ phân giải trên 2560 × 1440 là thử nghiệm. Dùng khung hợp lệ phù hợp bố cục và nêu chi tiết nhạy với cắt ảnh trong bản yêu cầu thay vì xem độ phân giải lớn hơn là cải thiện bố cục tự động.
Định dạng kết quả mặc định là PNG, với lựa chọn JPEG và WebP. JPEG và WebP cho phép mức nén từ 0 đến 100. Với nền trong suốt, chọn PNG hoặc WebP; nền đục và tự động cũng được hỗ trợ. Tài nguyên trong suốt có thể đặt vào bố cục sau, còn ảnh đục có phông nền riêng. Chọn định dạng, nền và nén theo nhu cầu bàn giao thực tế, giữ tệp hoàn chỉnh cùng bản yêu cầu và cài đặt đã chọn.
Nhà cung cấp ghi nhận việc tạo và sửa ảnh trực tiếp, cùng công cụ ảnh qua hội thoại có thể giữ kết quả được chọn để sửa tiếp. Trong quy trình đó, hành động có thể tự động, bắt buộc tạo mới hoặc bắt buộc chỉnh sửa khi ngữ cảnh có ảnh. Truyền phát có thể hiển thị tối đa ba ảnh từng phần trước kết quả cuối. Các bản xem trước thể hiện tiến độ chứ không phải thành phẩm bổ sung. Với công việc lặp, tiếp tục từ ảnh đã chọn và mô tả thay đổi nhìn thấy, chẳng hạn di chuyển một vật thể hoặc điều chỉnh cách xử lý màu. Giao diện nhà sản xuất cũng hỗ trợ xử lý theo lô.
Kiểm tra chữ, vị trí vật thể, chi tiết chủ thể và bố cục ở kích thước dự kiến. GPT Image vẫn có thể gặp khó với vị trí chữ chính xác, bố cục có cấu trúc và danh tính hình ảnh lặp lại qua các lần tạo. Giữ biến thể được chấp nhận làm tham chiếu tiếp theo và thu hẹp lần sửa sau vào vấn đề quan trọng. Vai trò tạo ảnh thường ngày của Flare hữu ích cho chuỗi rõ ràng gồm bản yêu cầu, các phương án hình ảnh, lựa chọn và tinh chỉnh, với tài nguyên cuối được đánh giá theo mục đích sáng tạo thực tế.
", "aboutText": "GPT Image 2.5 Flare là phiên bản tạo và chỉnh sửa hình ảnh của OpenAI hướng tới công việc hằng ngày nhanh, chất lượng cao. Mô hình nhận văn bản và hình ảnh, trả về kết quả hình ảnh. Dùng cho bản phác thảo, minh họa, ý tưởng sản phẩm và nhiệm vụ sáng tạo định kỳ cần nhanh chóng biến bản yêu cầu thành ảnh sử dụng được. Flare tách biệt với Sunburst, vốn chú trọng độ chính xác chỉnh sửa. Chọn Flare cho tạo ảnh thường ngày và Sunburst khi ưu tiên sửa chính xác.\n\nBắt đầu với chủ thể chính, hành động, môi trường, bố cục và cách thể hiện hình ảnh. Với minh họa chiến dịch, yêu cầu người đi xe đạp qua cầu nhỏ trong ánh chiều ấm, hình dáng nổi bật và bầu trời thoáng cho chữ thêm sau. Bản yêu cầu khám phá ngắn có thể để mở lựa chọn thẩm mỹ; bản yêu cầu sản xuất cần nêu chi tiết và vị trí quan trọng. Quy trình tạo và sửa trực tiếp cho phép lời nhắc tối đa 32,000 ký tự và từ một đến mười kết quả, hữu ích để so sánh vài biến thể theo cùng mục đích.\n\nKhi chỉnh sửa, có thể cung cấp tối đa mười sáu ảnh tham chiếu. Gán vai trò rõ cho mỗi ảnh thay vì mong mô hình tự quyết ảnh thể hiện danh tính chủ thể, cảnh vật hay phong cách. Mặt nạ có thể hướng dẫn sửa một vùng; với nhiều ảnh, nó áp dụng cho ảnh đầu tiên. Ảnh và mặt nạ phải cùng định dạng, kích thước, và mặt nạ phải chứa kênh alpha. Hướng dẫn yêu cầu nguồn và mặt nạ dưới 50 MB. Mặt nạ là chỉ dẫn chứ không cam kết giữ chính xác ranh giới, nên nêu cả thay đổi mong muốn và điều cần giữ dễ nhận ra.\n\nFlare hỗ trợ chất lượng low, medium, high, xhigh, max và tự động, mặc định auto. Chất lượng thấp hơn có thể phục vụ phác thảo nhanh; có thể so sánh các mức cao hơn cho chi tiết của tài nguyên cuối. Chất lượng độc lập với kích thước và nén đầu ra. Kích thước chuẩn gồm 1024 × 1024, 1536 × 1024 và 1024 × 1536, đồng thời có kích thước tự động hoặc tùy chỉnh. Chọn hướng khung theo vị trí cuối và không gian hữu ích của cảnh.\n\nChiều rộng, chiều cao tùy chỉnh phải là bội số của mười sáu, không cạnh nào trên 3840 pixel. Tỷ lệ cho phép từ 1:3 đến 3:1, và tổng diện tích ít nhất 655,360, nhiều nhất 8,294,400 pixel. Cả bốn điều kiện áp dụng đồng thời. Hướng dẫn xác định độ phân giải trên 2560 × 1440 là thử nghiệm. Dùng khung hợp lệ phù hợp bố cục và nêu chi tiết nhạy với cắt ảnh trong bản yêu cầu thay vì xem độ phân giải lớn hơn là cải thiện bố cục tự động.\n\nĐịnh dạng kết quả mặc định là PNG, với lựa chọn JPEG và WebP. JPEG và WebP cho phép mức nén từ 0 đến 100. Với nền trong suốt, chọn PNG hoặc WebP; nền đục và tự động cũng được hỗ trợ. Tài nguyên trong suốt có thể đặt vào bố cục sau, còn ảnh đục có phông nền riêng. Chọn định dạng, nền và nén theo nhu cầu bàn giao thực tế, giữ tệp hoàn chỉnh cùng bản yêu cầu và cài đặt đã chọn.\n\nNhà cung cấp ghi nhận việc tạo và sửa ảnh trực tiếp, cùng công cụ ảnh qua hội thoại có thể giữ kết quả được chọn để sửa tiếp. Trong quy trình đó, hành động có thể tự động, bắt buộc tạo mới hoặc bắt buộc chỉnh sửa khi ngữ cảnh có ảnh. Truyền phát có thể hiển thị tối đa ba ảnh từng phần trước kết quả cuối. Các bản xem trước thể hiện tiến độ chứ không phải thành phẩm bổ sung. Với công việc lặp, tiếp tục từ ảnh đã chọn và mô tả thay đổi nhìn thấy, chẳng hạn di chuyển một vật thể hoặc điều chỉnh cách xử lý màu. Giao diện nhà sản xuất cũng hỗ trợ xử lý theo lô.\n\nKiểm tra chữ, vị trí vật thể, chi tiết chủ thể và bố cục ở kích thước dự kiến. GPT Image vẫn có thể gặp khó với vị trí chữ chính xác, bố cục có cấu trúc và danh tính hình ảnh lặp lại qua các lần tạo. Giữ biến thể được chấp nhận làm tham chiếu tiếp theo và thu hẹp lần sửa sau vào vấn đề quan trọng. Vai trò tạo ảnh thường ngày của Flare hữu ích cho chuỗi rõ ràng gồm bản yêu cầu, các phương án hình ảnh, lựa chọn và tinh chỉnh, với tài nguyên cuối được đánh giá theo mục đích sáng tạo thực tế.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "44f06542806c390c5ce203704e4f0d36373f0c6ce6e8764dc3f6b7d0b2b73684", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "vi", "methods": [ { "html": "gpt-image-2.5-flareGPT Image 2.5 Flare tạo và chỉnh sửa hình ảnh từ văn bản cùng tham chiếu, tập trung vào sáng tạo hình ảnh hằng ngày nhanh chóng. Mô hình hỗ trợ kích thước tùy chỉnh, nền trong suốt, mặt nạ và chất lượng đến max cho bản phác thảo, minh họa và tài nguyên chiến dịch.
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 Image 2.5 Flare là phiên bản tạo và chỉnh sửa hình ảnh của OpenAI hướng tới công việc hằng ngày nhanh, chất lượng cao. Mô hình nhận văn bản và hình ảnh, trả về kết quả hình ảnh. Dùng cho bản phác thảo, minh họa, ý tưởng sản phẩm và nhiệm vụ sáng tạo định kỳ cần nhanh chóng biến bản yêu cầu thành ảnh sử dụng được. Flare tách biệt với Sunburst, vốn chú trọng độ chính xác chỉnh sửa. Chọn Flare cho tạo ảnh thường ngày và Sunburst khi ưu tiên sửa chính xác.
Bắt đầu với chủ thể chính, hành động, môi trường, bố cục và cách thể hiện hình ảnh. Với minh họa chiến dịch, yêu cầu người đi xe đạp qua cầu nhỏ trong ánh chiều ấm, hình dáng nổi bật và bầu trời thoáng cho chữ thêm sau. Bản yêu cầu khám phá ngắn có thể để mở lựa chọn thẩm mỹ; bản yêu cầu sản xuất cần nêu chi tiết và vị trí quan trọng. Quy trình tạo và sửa trực tiếp cho phép lời nhắc tối đa 32,000 ký tự và từ một đến mười kết quả, hữu ích để so sánh vài biến thể theo cùng mục đích.
Khi chỉnh sửa, có thể cung cấp tối đa mười sáu ảnh tham chiếu. Gán vai trò rõ cho mỗi ảnh thay vì mong mô hình tự quyết ảnh thể hiện danh tính chủ thể, cảnh vật hay phong cách. Mặt nạ có thể hướng dẫn sửa một vùng; với nhiều ảnh, nó áp dụng cho ảnh đầu tiên. Ảnh và mặt nạ phải cùng định dạng, kích thước, và mặt nạ phải chứa kênh alpha. Hướng dẫn yêu cầu nguồn và mặt nạ dưới 50 MB. Mặt nạ là chỉ dẫn chứ không cam kết giữ chính xác ranh giới, nên nêu cả thay đổi mong muốn và điều cần giữ dễ nhận ra.
Flare hỗ trợ chất lượng low, medium, high, xhigh, max và tự động, mặc định auto. Chất lượng thấp hơn có thể phục vụ phác thảo nhanh; có thể so sánh các mức cao hơn cho chi tiết của tài nguyên cuối. Chất lượng độc lập với kích thước và nén đầu ra. Kích thước chuẩn gồm 1024 × 1024, 1536 × 1024 và 1024 × 1536, đồng thời có kích thước tự động hoặc tùy chỉnh. Chọn hướng khung theo vị trí cuối và không gian hữu ích của cảnh.
Chiều rộng, chiều cao tùy chỉnh phải là bội số của mười sáu, không cạnh nào trên 3840 pixel. Tỷ lệ cho phép từ 1:3 đến 3:1, và tổng diện tích ít nhất 655,360, nhiều nhất 8,294,400 pixel. Cả bốn điều kiện áp dụng đồng thời. Hướng dẫn xác định độ phân giải trên 2560 × 1440 là thử nghiệm. Dùng khung hợp lệ phù hợp bố cục và nêu chi tiết nhạy với cắt ảnh trong bản yêu cầu thay vì xem độ phân giải lớn hơn là cải thiện bố cục tự động.
Định dạng kết quả mặc định là PNG, với lựa chọn JPEG và WebP. JPEG và WebP cho phép mức nén từ 0 đến 100. Với nền trong suốt, chọn PNG hoặc WebP; nền đục và tự động cũng được hỗ trợ. Tài nguyên trong suốt có thể đặt vào bố cục sau, còn ảnh đục có phông nền riêng. Chọn định dạng, nền và nén theo nhu cầu bàn giao thực tế, giữ tệp hoàn chỉnh cùng bản yêu cầu và cài đặt đã chọn.
Nhà cung cấp ghi nhận việc tạo và sửa ảnh trực tiếp, cùng công cụ ảnh qua hội thoại có thể giữ kết quả được chọn để sửa tiếp. Trong quy trình đó, hành động có thể tự động, bắt buộc tạo mới hoặc bắt buộc chỉnh sửa khi ngữ cảnh có ảnh. Truyền phát có thể hiển thị tối đa ba ảnh từng phần trước kết quả cuối. Các bản xem trước thể hiện tiến độ chứ không phải thành phẩm bổ sung. Với công việc lặp, tiếp tục từ ảnh đã chọn và mô tả thay đổi nhìn thấy, chẳng hạn di chuyển một vật thể hoặc điều chỉnh cách xử lý màu. Giao diện nhà sản xuất cũng hỗ trợ xử lý theo lô.
Kiểm tra chữ, vị trí vật thể, chi tiết chủ thể và bố cục ở kích thước dự kiến. GPT Image vẫn có thể gặp khó với vị trí chữ chính xác, bố cục có cấu trúc và danh tính hình ảnh lặp lại qua các lần tạo. Giữ biến thể được chấp nhận làm tham chiếu tiếp theo và thu hẹp lần sửa sau vào vấn đề quan trọng. Vai trò tạo ảnh thường ngày của Flare hữu ích cho chuỗi rõ ràng gồm bản yêu cầu, các phương án hình ảnh, lựa chọn và tinh chỉnh, với tài nguyên cuối được đánh giá theo mục đích sáng tạo thực tế.
POST /v1/images/generationstextimage| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
|---|---|---|---|---|
Trườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn gpt-image-2.5-flare | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn Độ dài tối thiểu: 1 | Mặc định— |
Trườngn | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: 1 | Mặc định1 |
Trườngresponse_format | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn url, b64_json | Mặc định— |
Trườngstream | Loạiboolean | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc địnhfalse |
Trườngsize | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— |
Trườngquality | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— |
Trườngbackground | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— |
Trườngoutput_format | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— |
Trườngoutput_compression | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— |
Trườngmoderation | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— |
Trườnginput_fidelity | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— |
Trườngstyle | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— |
Trườngpartial_images | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— |
Văn bản thành ảnh · Bắt buộc: prompt
| Tham số | Hợp đồng |
|---|---|
Tham sốmaterial_types | Hợp đồngtext |
Tham sốrequired | Hợp đồngmodel, prompt |
Tham sốoptional_controls | Hợp đồngnull |
Tham sốcontent_type | Hợp đồngapplication/json |
Vòng đời: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Giá trị task_id thực tế đã trả về hoặc bản ghi trong thư viện nội dung đa phương tiện
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Cấu trúc phương thức và ID là chính xác; khả năng của nhà cung cấp tách biệt với việc cho phép tiếp nhận yêu cầu.
POST /v1/images/generationsAiloot 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}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "gpt-image-2.5-flare", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nfrom openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'gpt-image-2.5-flare', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "gpt-image-2.5-flare", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\nTải xuống từng ảnh trả về hoặc lưu nội dung Base64 của ảnh
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Lưu mọi ảnh đã hoàn tất; truy xuất từng URL trả về hoặc giải mã nội dung Base64 của ảnh.
Lưu mọi phần tử dữ liệu. Giải mã từng b64_json hoặc tải xuống từ mọi URL có chữ ký đã trả về. Chọn phần mở rộng tệp dựa trên MIME/nội dung byte thực tế.
Nếu kết quả tạo hoặc chỉnh sửa ảnh cần được kiểm tra, giữ lại operation_id/X-Client-Request-ID gốc và thông tin kết quả đã trả về. Khôi phục các kết quả hiện có thuộc quyền sở hữu của bạn qua thư viện nội dung đa phương tiện bằng các giá trị task_id hoặc asset_id thực tế. Không gửi lại yêu cầu tạo/chỉnh sửa ảnh hoặc tạo URL truy vấn trạng thái từ operation_id.
| Trường | Loại |
|---|---|
Trườngcreated | Loạiinteger |
Trườngdata[].url | Loạistring |
Trườngdata[].b64_json | Loạibase64 string |
Trườngusage | Loạiobject |
| Phản hồi | Điều kiện | Bước tiếp theo |
|---|---|---|
Phản hồi400 · invalid_request_error | Điều kiệnTrường bắt buộc, cách biểu diễn tài liệu hoặc giá trị tham số không hợp lệ | Bước tiếp theoSửa các trường được chỉ ra trước khi gửi yêu cầu tạo mới. |
Phản hồiserver_error | Điều kiệnPhản hồi trả về cho biết thao tác hoặc kết quả cần được kiểm tra | Bước tiếp theoGiữ lại ID thao tác/tác vụ gốc đã trả về, các header của yêu cầu và toàn bộ phản hồi; tiếp tục truy xuất thao tác gốc đó bằng các phương thức được hỗ trợ. Không gửi lại yêu cầu tạo. |
Ailoot gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare
/v1/images
openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare
gpt-image-2.5-flareGPT Image 2.5 Flare tạo và chỉnh sửa hình ảnh từ văn bản cùng tham chiếu, tập trung vào sáng tạo hình ảnh hằng ngày nhanh chóng. Mô hình hỗ trợ kích thước tùy chỉnh, nền trong suốt, mặt nạ và chất lượng đến max cho bản phác thảo, minh họa và tài nguyên chiến dịch.
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 Image 2.5 Flare là phiên bản tạo và chỉnh sửa hình ảnh của OpenAI hướng tới công việc hằng ngày nhanh, chất lượng cao. Mô hình nhận văn bản và hình ảnh, trả về kết quả hình ảnh. Dùng cho bản phác thảo, minh họa, ý tưởng sản phẩm và nhiệm vụ sáng tạo định kỳ cần nhanh chóng biến bản yêu cầu thành ảnh sử dụng được. Flare tách biệt với Sunburst, vốn chú trọng độ chính xác chỉnh sửa. Chọn Flare cho tạo ảnh thường ngày và Sunburst khi ưu tiên sửa chính xác.
Bắt đầu với chủ thể chính, hành động, môi trường, bố cục và cách thể hiện hình ảnh. Với minh họa chiến dịch, yêu cầu người đi xe đạp qua cầu nhỏ trong ánh chiều ấm, hình dáng nổi bật và bầu trời thoáng cho chữ thêm sau. Bản yêu cầu khám phá ngắn có thể để mở lựa chọn thẩm mỹ; bản yêu cầu sản xuất cần nêu chi tiết và vị trí quan trọng. Quy trình tạo và sửa trực tiếp cho phép lời nhắc tối đa 32,000 ký tự và từ một đến mười kết quả, hữu ích để so sánh vài biến thể theo cùng mục đích.
Khi chỉnh sửa, có thể cung cấp tối đa mười sáu ảnh tham chiếu. Gán vai trò rõ cho mỗi ảnh thay vì mong mô hình tự quyết ảnh thể hiện danh tính chủ thể, cảnh vật hay phong cách. Mặt nạ có thể hướng dẫn sửa một vùng; với nhiều ảnh, nó áp dụng cho ảnh đầu tiên. Ảnh và mặt nạ phải cùng định dạng, kích thước, và mặt nạ phải chứa kênh alpha. Hướng dẫn yêu cầu nguồn và mặt nạ dưới 50 MB. Mặt nạ là chỉ dẫn chứ không cam kết giữ chính xác ranh giới, nên nêu cả thay đổi mong muốn và điều cần giữ dễ nhận ra.
Flare hỗ trợ chất lượng low, medium, high, xhigh, max và tự động, mặc định auto. Chất lượng thấp hơn có thể phục vụ phác thảo nhanh; có thể so sánh các mức cao hơn cho chi tiết của tài nguyên cuối. Chất lượng độc lập với kích thước và nén đầu ra. Kích thước chuẩn gồm 1024 × 1024, 1536 × 1024 và 1024 × 1536, đồng thời có kích thước tự động hoặc tùy chỉnh. Chọn hướng khung theo vị trí cuối và không gian hữu ích của cảnh.
Chiều rộng, chiều cao tùy chỉnh phải là bội số của mười sáu, không cạnh nào trên 3840 pixel. Tỷ lệ cho phép từ 1:3 đến 3:1, và tổng diện tích ít nhất 655,360, nhiều nhất 8,294,400 pixel. Cả bốn điều kiện áp dụng đồng thời. Hướng dẫn xác định độ phân giải trên 2560 × 1440 là thử nghiệm. Dùng khung hợp lệ phù hợp bố cục và nêu chi tiết nhạy với cắt ảnh trong bản yêu cầu thay vì xem độ phân giải lớn hơn là cải thiện bố cục tự động.
Định dạng kết quả mặc định là PNG, với lựa chọn JPEG và WebP. JPEG và WebP cho phép mức nén từ 0 đến 100. Với nền trong suốt, chọn PNG hoặc WebP; nền đục và tự động cũng được hỗ trợ. Tài nguyên trong suốt có thể đặt vào bố cục sau, còn ảnh đục có phông nền riêng. Chọn định dạng, nền và nén theo nhu cầu bàn giao thực tế, giữ tệp hoàn chỉnh cùng bản yêu cầu và cài đặt đã chọn.
Nhà cung cấp ghi nhận việc tạo và sửa ảnh trực tiếp, cùng công cụ ảnh qua hội thoại có thể giữ kết quả được chọn để sửa tiếp. Trong quy trình đó, hành động có thể tự động, bắt buộc tạo mới hoặc bắt buộc chỉnh sửa khi ngữ cảnh có ảnh. Truyền phát có thể hiển thị tối đa ba ảnh từng phần trước kết quả cuối. Các bản xem trước thể hiện tiến độ chứ không phải thành phẩm bổ sung. Với công việc lặp, tiếp tục từ ảnh đã chọn và mô tả thay đổi nhìn thấy, chẳng hạn di chuyển một vật thể hoặc điều chỉnh cách xử lý màu. Giao diện nhà sản xuất cũng hỗ trợ xử lý theo lô.
Kiểm tra chữ, vị trí vật thể, chi tiết chủ thể và bố cục ở kích thước dự kiến. GPT Image vẫn có thể gặp khó với vị trí chữ chính xác, bố cục có cấu trúc và danh tính hình ảnh lặp lại qua các lần tạo. Giữ biến thể được chấp nhận làm tham chiếu tiếp theo và thu hẹp lần sửa sau vào vấn đề quan trọng. Vai trò tạo ảnh thường ngày của Flare hữu ích cho chuỗi rõ ràng gồm bản yêu cầu, các phương án hình ảnh, lựa chọn và tinh chỉnh, với tài nguyên cuối được đánh giá theo mục đích sáng tạo thực tế.
POST /v1/images/generationstextimage| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
|---|---|---|---|---|
Trườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn gpt-image-2.5-flare | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn Độ dài tối đa: 32.000 | Mặc định— |
Trườngsize | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: Dùng auto hoặc WIDTHxHEIGHT với cả hai kích thước chia hết cho 16. Cạnh dài nhất tối đa 3,840 pixel và tổng kích thước tối đa 8,300,000 pixel. | Mặc địnhauto |
Trườngbackground | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn transparent, opaque, auto | Mặc địnhauto |
Trườngmoderation | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn low, auto Điều kiện: Dùng auto để kiểm duyệt nội dung tiêu chuẩn. | Mặc định— |
Trườngn | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: 1 Tối đa: 10 | Mặc định1 |
Trườngquality | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn auto, high, medium, low | Mặc địnhauto |
Trườngoutput_compression | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: 0 Tối đa: 100 Điều kiện: Áp dụng cho đầu ra JPEG và WebP; gửi giá trị số nguyên theo tài liệu. | Mặc định100 |
Trườngoutput_format | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn webp, png, jpeg | Mặc địnhpng |
Trườngstream | Loạiboolean | Yêu cầuKhông bắt buộc | Giá trị & giới hạn false Điều kiện: Tuyến này trả về một phản hồi JSON hoàn chỉnh. | Mặc địnhfalse |
| Tham số | Hợp đồng |
|---|---|
Tham sốcontent_type | Hợp đồngapplication/json |
Tham sốrequired | Hợp đồngprompt, model |
Tham sốmaterial_types | Hợp đồngtext |
Tham sốoptional | Hợp đồngsize, background, moderation, n, quality, output_compression, output_format, stream |
Tham sốconditions | Hợp đồngNền trong suốt yêu cầu định dạng PNG hoặc WebP., Nén đầu ra áp dụng cho JPEG hoặc WebP., Phương thức đã chọn tạo từ văn bản. Các tùy chọn chỉnh sửa và truyền trực tuyến mà nhà sản xuất mô tả là những khả năng riêng biệt. |
Vòng đời: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Giá trị task_id thực tế đã trả về hoặc bản ghi trong thư viện nội dung đa phương tiện
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Các đơn giá hiển thị dùng để ước tính chi phí trước khi tạo. Khoản phí cuối cùng được tính dựa trên chi phí ghi nhận cho lượt tạo gốc. Thời lượng đầu ra đo được và số lượng dự kiến không phải là số lượng cuối cùng dùng để tính phí.
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í | Số lượng dự báo | Phí |
|---|---|---|---|
| Cấu hìnhGiá cơ sở cho token | Biểu mức phíMức phí cơ bản | Số lượng dự báo— | Phí Đầu vào · Token đầu vào · Ước tính chỉ để so sánh — / 1K token Đầu ra · Token đầu ra · Ước tính chỉ để so sánh — / 1K token Đầu vào · Đọc bộ nhớ đệm · Ước tính chỉ để so sánh — / 1K token Đầu vào · Ghi bộ nhớ đệm · Ước tính chỉ để so sánh — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ · Ước tính chỉ để so sánh — / 1K token |
| Cấu hìnhChi phí tạo ước tính | Biểu mức phí— | Số lượng dự báoước tính cho một lần tạo | Phí Đầu ra · Chi phí tạo ước tính · Ước tính chỉ để so sánh $0.24576 ước tính trước khi tạo Ước tính này không phải là khoản phí bổ sung hay mức giá cố định cho lượt tạo đã hoàn tất. |
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}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'prompt': 'A cute baby sea otter', 'model': 'gpt-image-2.5-flare', 'size': '1024x1024', 'n': 1, 'background': 'auto', 'moderation': 'auto', 'output_format': 'png'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nTải xuống từng ảnh trả về hoặc lưu nội dung Base64 của ảnh
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nLưu mọi ảnh đã hoàn tất; truy xuất từng URL trả về hoặc giải mã nội dung Base64 của ảnh.
Giữ lại toàn bộ phản hồi và các header, mọi đầu ra thực tế, các định danh gốc đã trả về và mọi trường usage. Khôi phục thao tác gốc mà không gửi lại yêu cầu tạo.
Giữ lại X-Client-Request-ID đã trả về để đối soát. Chỉ truy xuất theo các giá trị task_id/asset_id thực tế đã trả về hoặc từ thư viện nội dung đa phương tiện thuộc quyền sở hữu của bạn; tuyệt đối không tạo URL tác vụ từ ID thao tác và không gửi lại yêu cầu tạo.
| Trường | Loại |
|---|---|
Trườngcreated | Loại |
Trườngdata[].url | Loại |
Trườngdata[].b64_json | Loại |
Trườngusage | Loại |
Ailoot gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare
/v1/images
openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare
openai/gpt-image-2.5-flareGPT Image 2.5 Flare tạo và chỉnh sửa hình ảnh từ văn bản cùng tham chiếu, tập trung vào sáng tạo hình ảnh hằng ngày nhanh chóng. Mô hình hỗ trợ kích thước tùy chỉnh, nền trong suốt, mặt nạ và chất lượng đến max cho bản phác thảo, minh họa và tài nguyên chiến dịch.
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 Image 2.5 Flare là phiên bản tạo và chỉnh sửa hình ảnh của OpenAI hướng tới công việc hằng ngày nhanh, chất lượng cao. Mô hình nhận văn bản và hình ảnh, trả về kết quả hình ảnh. Dùng cho bản phác thảo, minh họa, ý tưởng sản phẩm và nhiệm vụ sáng tạo định kỳ cần nhanh chóng biến bản yêu cầu thành ảnh sử dụng được. Flare tách biệt với Sunburst, vốn chú trọng độ chính xác chỉnh sửa. Chọn Flare cho tạo ảnh thường ngày và Sunburst khi ưu tiên sửa chính xác.
Bắt đầu với chủ thể chính, hành động, môi trường, bố cục và cách thể hiện hình ảnh. Với minh họa chiến dịch, yêu cầu người đi xe đạp qua cầu nhỏ trong ánh chiều ấm, hình dáng nổi bật và bầu trời thoáng cho chữ thêm sau. Bản yêu cầu khám phá ngắn có thể để mở lựa chọn thẩm mỹ; bản yêu cầu sản xuất cần nêu chi tiết và vị trí quan trọng. Quy trình tạo và sửa trực tiếp cho phép lời nhắc tối đa 32,000 ký tự và từ một đến mười kết quả, hữu ích để so sánh vài biến thể theo cùng mục đích.
Khi chỉnh sửa, có thể cung cấp tối đa mười sáu ảnh tham chiếu. Gán vai trò rõ cho mỗi ảnh thay vì mong mô hình tự quyết ảnh thể hiện danh tính chủ thể, cảnh vật hay phong cách. Mặt nạ có thể hướng dẫn sửa một vùng; với nhiều ảnh, nó áp dụng cho ảnh đầu tiên. Ảnh và mặt nạ phải cùng định dạng, kích thước, và mặt nạ phải chứa kênh alpha. Hướng dẫn yêu cầu nguồn và mặt nạ dưới 50 MB. Mặt nạ là chỉ dẫn chứ không cam kết giữ chính xác ranh giới, nên nêu cả thay đổi mong muốn và điều cần giữ dễ nhận ra.
Flare hỗ trợ chất lượng low, medium, high, xhigh, max và tự động, mặc định auto. Chất lượng thấp hơn có thể phục vụ phác thảo nhanh; có thể so sánh các mức cao hơn cho chi tiết của tài nguyên cuối. Chất lượng độc lập với kích thước và nén đầu ra. Kích thước chuẩn gồm 1024 × 1024, 1536 × 1024 và 1024 × 1536, đồng thời có kích thước tự động hoặc tùy chỉnh. Chọn hướng khung theo vị trí cuối và không gian hữu ích của cảnh.
Chiều rộng, chiều cao tùy chỉnh phải là bội số của mười sáu, không cạnh nào trên 3840 pixel. Tỷ lệ cho phép từ 1:3 đến 3:1, và tổng diện tích ít nhất 655,360, nhiều nhất 8,294,400 pixel. Cả bốn điều kiện áp dụng đồng thời. Hướng dẫn xác định độ phân giải trên 2560 × 1440 là thử nghiệm. Dùng khung hợp lệ phù hợp bố cục và nêu chi tiết nhạy với cắt ảnh trong bản yêu cầu thay vì xem độ phân giải lớn hơn là cải thiện bố cục tự động.
Định dạng kết quả mặc định là PNG, với lựa chọn JPEG và WebP. JPEG và WebP cho phép mức nén từ 0 đến 100. Với nền trong suốt, chọn PNG hoặc WebP; nền đục và tự động cũng được hỗ trợ. Tài nguyên trong suốt có thể đặt vào bố cục sau, còn ảnh đục có phông nền riêng. Chọn định dạng, nền và nén theo nhu cầu bàn giao thực tế, giữ tệp hoàn chỉnh cùng bản yêu cầu và cài đặt đã chọn.
Nhà cung cấp ghi nhận việc tạo và sửa ảnh trực tiếp, cùng công cụ ảnh qua hội thoại có thể giữ kết quả được chọn để sửa tiếp. Trong quy trình đó, hành động có thể tự động, bắt buộc tạo mới hoặc bắt buộc chỉnh sửa khi ngữ cảnh có ảnh. Truyền phát có thể hiển thị tối đa ba ảnh từng phần trước kết quả cuối. Các bản xem trước thể hiện tiến độ chứ không phải thành phẩm bổ sung. Với công việc lặp, tiếp tục từ ảnh đã chọn và mô tả thay đổi nhìn thấy, chẳng hạn di chuyển một vật thể hoặc điều chỉnh cách xử lý màu. Giao diện nhà sản xuất cũng hỗ trợ xử lý theo lô.
Kiểm tra chữ, vị trí vật thể, chi tiết chủ thể và bố cục ở kích thước dự kiến. GPT Image vẫn có thể gặp khó với vị trí chữ chính xác, bố cục có cấu trúc và danh tính hình ảnh lặp lại qua các lần tạo. Giữ biến thể được chấp nhận làm tham chiếu tiếp theo và thu hẹp lần sửa sau vào vấn đề quan trọng. Vai trò tạo ảnh thường ngày của Flare hữu ích cho chuỗi rõ ràng gồm bản yêu cầu, các phương án hình ảnh, lựa chọn và tinh chỉnh, với tài nguyên cuối được đánh giá theo mục đích sáng tạo thực tế.
POST /v1/images/generationstext, imageimage| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
|---|---|---|---|---|
Trườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn openai/gpt-image-2.5-flare | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn Độ dài tối thiểu: 1 | Mặc định— |
Trườngaspect_ratio | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, auto | Mặc định— |
Trườngquality | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn auto, low, medium, high, xhigh, max | Mặc định— |
Trườngbackground | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn auto, transparent, opaque | Mặc định— |
Trườngn | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: 1 Tối đa: 10 | Mặc định— |
Trườnginput_references | Loạiarray | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Số mục tối thiểu: 0 Số mục tối đa: 16 | Mặc định— |
Trườngoutput_compression | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: 0 Tối đa: 100 | Mặc định— |
Trườngprovider | Loạiobject | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
| Tham số | Hợp đồng |
|---|---|
Tham sốcontent_type | Hợp đồngapplication/json |
Tham sốrequired | Hợp đồngmodel, prompt |
Tham sốmaterial_types | Hợp đồngtext, image |
Vòng đời: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Giá trị task_id thực tế đã trả về hoặc bản ghi trong thư viện nội dung đa phương tiện
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Các đơn giá hiển thị dùng để ước tính chi phí trước khi tạo. Khoản phí cuối cùng được tính dựa trên chi phí ghi nhận cho lượt tạo gốc. Thời lượng đầu ra đo được và số lượng dự kiến không phải là số lượng cuối cùng dùng để tính phí.
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í | Số lượng dự báo | Phí |
|---|---|---|---|
| Cấu hìnhGiá cơ sở cho token | Biểu mức phíMức phí cơ bản | Số lượng dự báo— | Phí Đầu vào · Token đầu vào · Ước tính chỉ để so sánh — / 1K token Đầu ra · Token đầu ra · Ước tính chỉ để so sánh — / 1K token Đầu vào · Đọc bộ nhớ đệm · Ước tính chỉ để so sánh — / 1K token Đầu vào · Ghi bộ nhớ đệm · Ước tính chỉ để so sánh — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ · Ước tính chỉ để so sánh — / 1K token |
| Cấu hìnhChi phí tạo ước tính | Biểu mức phí— | Số lượng dự báoước tính cho một lần tạo | Phí Đầu ra · Chi phí tạo ước tính · Ước tính chỉ để so sánh $0.24576 ước tính trước khi tạo Ước tính này không phải là khoản phí bổ sung hay mức giá cố định cho lượt tạo đã hoàn tất. |
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}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'openai/gpt-image-2.5-flare', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nTải xuống từng ảnh trả về hoặc lưu nội dung Base64 của ảnh
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nLưu mọi ảnh đã hoàn tất; truy xuất từng URL trả về hoặc giải mã nội dung Base64 của ảnh.
Giữ lại toàn bộ phản hồi và các header, mọi đầu ra thực tế, các định danh gốc đã trả về và mọi trường usage. Khôi phục thao tác gốc mà không gửi lại yêu cầu tạo.
Giữ lại X-Client-Request-ID đã trả về để đối soát. Chỉ truy xuất theo các giá trị task_id/asset_id thực tế đã trả về hoặc từ thư viện nội dung đa phương tiện thuộc quyền sở hữu của bạn; tuyệt đối không tạo URL tác vụ từ ID thao tác và không gửi lại yêu cầu tạo.
| Trường | Loại |
|---|---|
Trườngcreated | Loại |
Trườngdata[].url | Loại |
Trườngdata[].b64_json | Loại |
Trườngusage | Loại |
Ailoot gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare
/v1/images
openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare