HY Image 3.5 Preview là mô hình tạo và chỉnh sửa ảnh hợp nhất của Tencent. Mô hình nhận bản yêu cầu viết với ảnh tham chiếu tuỳ chọn và hỗ trợ tiếp tục cùng tác vụ thị giác qua nhiều lượt. Kết quả là ảnh cho cảnh, bố cục hoặc chỉnh sửa đã xác định. Ví dụ của Tencent gồm ảnh sản phẩm, áp phích chiến dịch, hình ảnh thiết kế giao diện và ý tưởng chất liệu. Chọn tác vụ cần ảnh mới, bố cục có tham chiếu định hướng hay thay đổi có trọng tâm trên kết quả có sẵn.
Nhà sản xuất xác định phiên bản là hy-image-v3.5-preview và công bố giới hạn câu lệnh 100K token. Đầu vào là hội thoại theo trình tự thời gian chứa văn bản và ảnh, với tin nhắn cuối cùng của người dùng cung cấp chỉ dẫn hiện tại. Tin nhắn trước cung cấp ngữ cảnh cho chỉnh sửa lặp lại. Điều này khác quy trình một câu lệnh của HY Image 3.0 và giới hạn đầu vào riêng của nó. Với tác vụ thiết kế liên tục, giữ bản yêu cầu liên quan, vai trò tham chiếu và ảnh đã chọn để chỉ dẫn tiếp theo phát triển từ trạng thái thị giác dự định.
Chuẩn bị ảnh tham chiếu PNG hoặc JPEG/JPG. Đầu vào tham chiếu có thể chứa tối đa 20 ảnh, mỗi ảnh không lớn hơn 20 MB trong quy trình được công bố. Có thể cung cấp ảnh dưới dạng tài nguyên được tham chiếu hoặc đã mã hoá. Nếu hội thoại mang quá nhiều ảnh, hướng dẫn nhà sản xuất mô tả cắt bỏ ảnh cũ trước. Giữ bộ tham chiếu đang dùng có trọng tâm thay vì dựa vào mọi ảnh lịch sử còn trong ngữ cảnh. Tuỳ chọn đổi kích thước đầu vào giữ ảnh nhỏ hơn và thu phóng ảnh lớn theo tỷ lệ về diện tích điểm ảnh đích; đích mặc định là 1,048,576 pixel. Giữ đủ chi tiết nhìn thấy cho sản phẩm, chất liệu hoặc bố cục cần định hướng kết quả.
Kích thước đầu ra có hai cách chuẩn bị riêng. Với tự chọn kích thước, generate_max_pixels đặt diện tích đích: 1,048,576 pixel cho mức 1K, 2,359,296 cho mức 1.5K mặc định hoặc 4,194,304 cho 2K. FAQ của nhà sản xuất nêu thiết lập diện tích đích được cung cấp một mình mặc định tỷ lệ vuông. Khi bỏ qua cả hai tuỳ chọn kích thước, mô hình dùng bản yêu cầu và mức 1.5K mặc định. Các mức đó không tạo thiết lập 4K tự động. Dùng mức diện tích khi ảnh vuông phù hợp tác vụ. Để bản yêu cầu định hướng tỷ lệ ở mức 1.5K mặc định, bỏ cả hai tuỳ chọn kích thước; yêu cầu kích thước rõ khi bố cục cần cỡ dọc hoặc rộng cụ thể.
Với kích thước chỉ định, nhà sản xuất cho phép các cạnh là số nguyên dương từ 256 đến 8192 pixel, với tổng diện tích không lớn hơn 16,777,216 pixel. Hình vuông 4096 × 4096 đáp ứng giới hạn đó. Khoảng chiều dài cạnh và trần diện tích cùng áp dụng, nên cạnh 8192 pixel không cho phép ảnh 8192 × 8192. Yêu cầu chiều rộng và chiều cao cần thiết rõ ràng khi bố cục cuối cần kích thước cụ thể, thay vì mặc định mức diện tích đích xác định cùng kích thước. Giữ chi tiết dễ bị ảnh hưởng khi cắt và khoảng trống cần có rõ trong câu lệnh.
Mô hình hỗ trợ chỉnh sửa nhiều lượt qua lịch sử hội thoại trả về. Tencent phân biệt ảnh cuối bàn giao với ảnh trung gian dùng làm ngữ cảnh lần sửa tiếp theo, và ví dụ giữ suy luận của trợ lý, yêu cầu công cụ và kết quả ảnh được tạo khi tiếp tục. Với bố cục sản phẩm, trước tiên xác lập chủ thể và khung hình; rồi yêu cầu đổi ánh sáng hoặc nền mới trong khi chỉ rõ phần cần giữ diện mạo. Lưu kết quả đã chọn cùng lịch sử để lượt tiếp theo làm việc trên ảnh đó thay vì biến thể đã bỏ. Trong quy trình được Tencent công bố, cả liên kết ảnh cuối lẫn ảnh lịch sử hết hạn sau 12 giờ, nên lưu tài nguyên ảnh trước khi dựa vào chúng cho lần sửa về sau.
Các tuỳ chọn được công bố gồm seed, chú thích thuỷ vân tuỳ chỉnh tối đa 16 ký tự và tăng cường bằng tìm kiếm bên ngoài tuỳ chọn, mặc định tắt. Seed là số nguyên không âm; bằng không hoặc bỏ qua sẽ để nhà sản xuất chọn ngẫu nhiên. Những tuỳ chọn này có mục đích khác chính bản yêu cầu. Với hình ảnh sản phẩm dựa trên tham chiếu, mô tả diện mạo sản phẩm, góc máy, bề mặt, ánh sáng và bố cục dự định, rồi dùng tham chiếu để định hướng chi tiết nhận diện. Với áp phích, đưa thứ bậc và nội dung chính xác thay vì để thông điệp được tự bịa.
Hướng dẫn thực tế của Tencent khuyến nghị kiểm tra chữ và bố cục, nhất là khi thông số sản phẩm, tên tổ chức hoặc nội dung mang tính dữ kiện khác quan trọng. Kiểm tra ảnh hoàn chỉnh về chủ thể, tỷ lệ, chất liệu, vùng cắt và chữ. Lưu tài nguyên cuối cùng với bản yêu cầu và thiết lập, rồi dùng chỉ dẫn cụ thể gắn với vấn đề nhìn thấy cho lần sửa tiếp theo.
", "aboutText": "HY Image 3.5 Preview là mô hình tạo và chỉnh sửa ảnh hợp nhất của Tencent. Mô hình nhận bản yêu cầu viết với ảnh tham chiếu tuỳ chọn và hỗ trợ tiếp tục cùng tác vụ thị giác qua nhiều lượt. Kết quả là ảnh cho cảnh, bố cục hoặc chỉnh sửa đã xác định. Ví dụ của Tencent gồm ảnh sản phẩm, áp phích chiến dịch, hình ảnh thiết kế giao diện và ý tưởng chất liệu. Chọn tác vụ cần ảnh mới, bố cục có tham chiếu định hướng hay thay đổi có trọng tâm trên kết quả có sẵn.\n\nNhà sản xuất xác định phiên bản là hy-image-v3.5-preview và công bố giới hạn câu lệnh 100K token. Đầu vào là hội thoại theo trình tự thời gian chứa văn bản và ảnh, với tin nhắn cuối cùng của người dùng cung cấp chỉ dẫn hiện tại. Tin nhắn trước cung cấp ngữ cảnh cho chỉnh sửa lặp lại. Điều này khác quy trình một câu lệnh của HY Image 3.0 và giới hạn đầu vào riêng của nó. Với tác vụ thiết kế liên tục, giữ bản yêu cầu liên quan, vai trò tham chiếu và ảnh đã chọn để chỉ dẫn tiếp theo phát triển từ trạng thái thị giác dự định.\n\nChuẩn bị ảnh tham chiếu PNG hoặc JPEG/JPG. Đầu vào tham chiếu có thể chứa tối đa 20 ảnh, mỗi ảnh không lớn hơn 20 MB trong quy trình được công bố. Có thể cung cấp ảnh dưới dạng tài nguyên được tham chiếu hoặc đã mã hoá. Nếu hội thoại mang quá nhiều ảnh, hướng dẫn nhà sản xuất mô tả cắt bỏ ảnh cũ trước. Giữ bộ tham chiếu đang dùng có trọng tâm thay vì dựa vào mọi ảnh lịch sử còn trong ngữ cảnh. Tuỳ chọn đổi kích thước đầu vào giữ ảnh nhỏ hơn và thu phóng ảnh lớn theo tỷ lệ về diện tích điểm ảnh đích; đích mặc định là 1,048,576 pixel. Giữ đủ chi tiết nhìn thấy cho sản phẩm, chất liệu hoặc bố cục cần định hướng kết quả.\n\nKích thước đầu ra có hai cách chuẩn bị riêng. Với tự chọn kích thước, generate_max_pixels đặt diện tích đích: 1,048,576 pixel cho mức 1K, 2,359,296 cho mức 1.5K mặc định hoặc 4,194,304 cho 2K. FAQ của nhà sản xuất nêu thiết lập diện tích đích được cung cấp một mình mặc định tỷ lệ vuông. Khi bỏ qua cả hai tuỳ chọn kích thước, mô hình dùng bản yêu cầu và mức 1.5K mặc định. Các mức đó không tạo thiết lập 4K tự động. Dùng mức diện tích khi ảnh vuông phù hợp tác vụ. Để bản yêu cầu định hướng tỷ lệ ở mức 1.5K mặc định, bỏ cả hai tuỳ chọn kích thước; yêu cầu kích thước rõ khi bố cục cần cỡ dọc hoặc rộng cụ thể.\n\nVới kích thước chỉ định, nhà sản xuất cho phép các cạnh là số nguyên dương từ 256 đến 8192 pixel, với tổng diện tích không lớn hơn 16,777,216 pixel. Hình vuông 4096 × 4096 đáp ứng giới hạn đó. Khoảng chiều dài cạnh và trần diện tích cùng áp dụng, nên cạnh 8192 pixel không cho phép ảnh 8192 × 8192. Yêu cầu chiều rộng và chiều cao cần thiết rõ ràng khi bố cục cuối cần kích thước cụ thể, thay vì mặc định mức diện tích đích xác định cùng kích thước. Giữ chi tiết dễ bị ảnh hưởng khi cắt và khoảng trống cần có rõ trong câu lệnh.\n\nMô hình hỗ trợ chỉnh sửa nhiều lượt qua lịch sử hội thoại trả về. Tencent phân biệt ảnh cuối bàn giao với ảnh trung gian dùng làm ngữ cảnh lần sửa tiếp theo, và ví dụ giữ suy luận của trợ lý, yêu cầu công cụ và kết quả ảnh được tạo khi tiếp tục. Với bố cục sản phẩm, trước tiên xác lập chủ thể và khung hình; rồi yêu cầu đổi ánh sáng hoặc nền mới trong khi chỉ rõ phần cần giữ diện mạo. Lưu kết quả đã chọn cùng lịch sử để lượt tiếp theo làm việc trên ảnh đó thay vì biến thể đã bỏ. Trong quy trình được Tencent công bố, cả liên kết ảnh cuối lẫn ảnh lịch sử hết hạn sau 12 giờ, nên lưu tài nguyên ảnh trước khi dựa vào chúng cho lần sửa về sau.\n\nCác tuỳ chọn được công bố gồm seed, chú thích thuỷ vân tuỳ chỉnh tối đa 16 ký tự và tăng cường bằng tìm kiếm bên ngoài tuỳ chọn, mặc định tắt. Seed là số nguyên không âm; bằng không hoặc bỏ qua sẽ để nhà sản xuất chọn ngẫu nhiên. Những tuỳ chọn này có mục đích khác chính bản yêu cầu. Với hình ảnh sản phẩm dựa trên tham chiếu, mô tả diện mạo sản phẩm, góc máy, bề mặt, ánh sáng và bố cục dự định, rồi dùng tham chiếu để định hướng chi tiết nhận diện. Với áp phích, đưa thứ bậc và nội dung chính xác thay vì để thông điệp được tự bịa.\n\nHướng dẫn thực tế của Tencent khuyến nghị kiểm tra chữ và bố cục, nhất là khi thông số sản phẩm, tên tổ chức hoặc nội dung mang tính dữ kiện khác quan trọng. Kiểm tra ảnh hoàn chỉnh về chủ thể, tỷ lệ, chất liệu, vùng cắt và chữ. Lưu tài nguyên cuối cùng với bản yêu cầu và thiết lập, rồi dùng chỉ dẫn cụ thể gắn với vấn đề nhìn thấy cho lần sửa tiếp theo.\n\n", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "fd7dd5c8875cd87cfb3362774ce54a6c0103d0b0c1638a255dde8d7b91a421e2", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "vi", "methods": [ { "html": "tencent/hy-image-v3.5-previewHY Image 3.5 Preview kết hợp tạo ảnh từ văn bản, tạo dựa trên tham chiếu và chỉnh sửa nhiều lượt. Tencent công bố tối đa 20 ảnh tham chiếu, tự chọn kích thước và kích thước đầu ra chỉ định tối đa ảnh 4096 × 4096 cho công việc hình ảnh chi tiết.
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.
HY Image 3.5 Preview là mô hình tạo và chỉnh sửa ảnh hợp nhất của Tencent. Mô hình nhận bản yêu cầu viết với ảnh tham chiếu tuỳ chọn và hỗ trợ tiếp tục cùng tác vụ thị giác qua nhiều lượt. Kết quả là ảnh cho cảnh, bố cục hoặc chỉnh sửa đã xác định. Ví dụ của Tencent gồm ảnh sản phẩm, áp phích chiến dịch, hình ảnh thiết kế giao diện và ý tưởng chất liệu. Chọn tác vụ cần ảnh mới, bố cục có tham chiếu định hướng hay thay đổi có trọng tâm trên kết quả có sẵn.
Nhà sản xuất xác định phiên bản là hy-image-v3.5-preview và công bố giới hạn câu lệnh 100K token. Đầu vào là hội thoại theo trình tự thời gian chứa văn bản và ảnh, với tin nhắn cuối cùng của người dùng cung cấp chỉ dẫn hiện tại. Tin nhắn trước cung cấp ngữ cảnh cho chỉnh sửa lặp lại. Điều này khác quy trình một câu lệnh của HY Image 3.0 và giới hạn đầu vào riêng của nó. Với tác vụ thiết kế liên tục, giữ bản yêu cầu liên quan, vai trò tham chiếu và ảnh đã chọn để chỉ dẫn tiếp theo phát triển từ trạng thái thị giác dự định.
Chuẩn bị ảnh tham chiếu PNG hoặc JPEG/JPG. Đầu vào tham chiếu có thể chứa tối đa 20 ảnh, mỗi ảnh không lớn hơn 20 MB trong quy trình được công bố. Có thể cung cấp ảnh dưới dạng tài nguyên được tham chiếu hoặc đã mã hoá. Nếu hội thoại mang quá nhiều ảnh, hướng dẫn nhà sản xuất mô tả cắt bỏ ảnh cũ trước. Giữ bộ tham chiếu đang dùng có trọng tâm thay vì dựa vào mọi ảnh lịch sử còn trong ngữ cảnh. Tuỳ chọn đổi kích thước đầu vào giữ ảnh nhỏ hơn và thu phóng ảnh lớn theo tỷ lệ về diện tích điểm ảnh đích; đích mặc định là 1,048,576 pixel. Giữ đủ chi tiết nhìn thấy cho sản phẩm, chất liệu hoặc bố cục cần định hướng kết quả.
Kích thước đầu ra có hai cách chuẩn bị riêng. Với tự chọn kích thước, generate_max_pixels đặt diện tích đích: 1,048,576 pixel cho mức 1K, 2,359,296 cho mức 1.5K mặc định hoặc 4,194,304 cho 2K. FAQ của nhà sản xuất nêu thiết lập diện tích đích được cung cấp một mình mặc định tỷ lệ vuông. Khi bỏ qua cả hai tuỳ chọn kích thước, mô hình dùng bản yêu cầu và mức 1.5K mặc định. Các mức đó không tạo thiết lập 4K tự động. Dùng mức diện tích khi ảnh vuông phù hợp tác vụ. Để bản yêu cầu định hướng tỷ lệ ở mức 1.5K mặc định, bỏ cả hai tuỳ chọn kích thước; yêu cầu kích thước rõ khi bố cục cần cỡ dọc hoặc rộng cụ thể.
Với kích thước chỉ định, nhà sản xuất cho phép các cạnh là số nguyên dương từ 256 đến 8192 pixel, với tổng diện tích không lớn hơn 16,777,216 pixel. Hình vuông 4096 × 4096 đáp ứng giới hạn đó. Khoảng chiều dài cạnh và trần diện tích cùng áp dụng, nên cạnh 8192 pixel không cho phép ảnh 8192 × 8192. Yêu cầu chiều rộng và chiều cao cần thiết rõ ràng khi bố cục cuối cần kích thước cụ thể, thay vì mặc định mức diện tích đích xác định cùng kích thước. Giữ chi tiết dễ bị ảnh hưởng khi cắt và khoảng trống cần có rõ trong câu lệnh.
Mô hình hỗ trợ chỉnh sửa nhiều lượt qua lịch sử hội thoại trả về. Tencent phân biệt ảnh cuối bàn giao với ảnh trung gian dùng làm ngữ cảnh lần sửa tiếp theo, và ví dụ giữ suy luận của trợ lý, yêu cầu công cụ và kết quả ảnh được tạo khi tiếp tục. Với bố cục sản phẩm, trước tiên xác lập chủ thể và khung hình; rồi yêu cầu đổi ánh sáng hoặc nền mới trong khi chỉ rõ phần cần giữ diện mạo. Lưu kết quả đã chọn cùng lịch sử để lượt tiếp theo làm việc trên ảnh đó thay vì biến thể đã bỏ. Trong quy trình được Tencent công bố, cả liên kết ảnh cuối lẫn ảnh lịch sử hết hạn sau 12 giờ, nên lưu tài nguyên ảnh trước khi dựa vào chúng cho lần sửa về sau.
Các tuỳ chọn được công bố gồm seed, chú thích thuỷ vân tuỳ chỉnh tối đa 16 ký tự và tăng cường bằng tìm kiếm bên ngoài tuỳ chọn, mặc định tắt. Seed là số nguyên không âm; bằng không hoặc bỏ qua sẽ để nhà sản xuất chọn ngẫu nhiên. Những tuỳ chọn này có mục đích khác chính bản yêu cầu. Với hình ảnh sản phẩm dựa trên tham chiếu, mô tả diện mạo sản phẩm, góc máy, bề mặt, ánh sáng và bố cục dự định, rồi dùng tham chiếu để định hướng chi tiết nhận diện. Với áp phích, đưa thứ bậc và nội dung chính xác thay vì để thông điệp được tự bịa.
Hướng dẫn thực tế của Tencent khuyến nghị kiểm tra chữ và bố cục, nhất là khi thông số sản phẩm, tên tổ chức hoặc nội dung mang tính dữ kiện khác quan trọng. Kiểm tra ảnh hoàn chỉnh về chủ thể, tỷ lệ, chất liệu, vùng cắt và chữ. Lưu tài nguyên cuối cùng với bản yêu cầu và thiết lập, rồi dùng chỉ dẫn cụ thể gắn với vấn đề nhìn thấy cho lần sửa tiếp theo.
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 tencent/hy-image-v3.5-preview | 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ườngresolution | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 1K, 1.5K, 2K, 4K | 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, 1:2, 1:4, 2:1, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 9:16, 16:9 | 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: 1 | 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: 20 | 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 | Đơn vị tính phí | 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— | Đơn vị tính phí— | 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ìnhToken ảnh đầu ra | Biểu mức phí— | Số lượng dự báo— | Đơn vị tính phí/ 1K token hình ảnh | Phí Đầu ra · Token ảnh đầu ra · Ước tính chỉ để so sánh $0.0032 / 1K token hình ảnh |
| 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 | Đơn vị tính phí— | Phí Đầu ra · Chi phí tạo ước tính · Ước tính chỉ để so sánh $0.0131072 ướ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': 'tencent/hy-image-v3.5-preview', '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 Ultra tencent/hy-image-v3.5-preview
/v1/images