Phiên bản tạo ảnh nhanh hơn
Seedream 5.0 Flash là mô hình tạo và chỉnh sửa hình ảnh của ByteDance Seed cho quy trình ưu tiên tốc độ tạo. Hướng dẫn Pro/Flash của nhà sản xuất mô tả cả tạo ảnh từ văn bản lẫn từ ảnh với một hoặc nhiều tham chiếu. Hướng dẫn phân biệt Flash tạo nhanh hơn với Pro ưu tiên chất lượng ảnh cao hơn, nhưng không xác lập thời gian phản hồi cố định cho mọi bản yêu cầu.
Các tính năng chung đặc trưng là chỉnh sửa tương tác, phân tách lớp và tạo ảnh đa ngôn ngữ gốc. Tạo ảnh thông thường trả một ảnh hoàn chỉnh. Quy trình Flash của nhà sản xuất không hỗ trợ tạo chuỗi ảnh liên quan, tìm kiếm web hoặc trả ảnh theo luồng. Tối ưu câu lệnh dùng chế độ standard; tuỳ chọn tối ưu fast riêng thuộc Pro thay vì Flash.
Tạo ảnh từ bản yêu cầu và tham chiếu
Nêu hình ảnh dự định, chủ thể chính, bố cục và cách thể hiện thị giác, rồi xác định mỗi tham chiếu chi phối gì. Với hình ảnh sản phẩm, tách tham chiếu xác lập vật thể khỏi tham chiếu cung cấp bảng màu hoặc chất liệu bề mặt. “Giữ dáng vật thể và góc nhìn từ ảnh thứ nhất; chỉ dùng ảnh thứ hai cho bảng màu nền dịu” giao vai trò riêng cho tham chiếu.
Nhà sản xuất khuyến nghị câu lệnh ngắn gọn, không quá 300 ký tự tiếng Trung hoặc 600 từ tiếng Anh. Đây là hướng dẫn chuẩn bị, không phải ngưỡng cắt cứng đầu vào văn bản được nêu. Liệt kê yêu cầu quyết định trước, gồm nội dung chính xác phải xuất hiện, tỷ lệ khung hình mong muốn và chi tiết phải giữ nguyên. Kiểm tra ảnh hoàn chỉnh theo danh sách đó thay vì chỉ dựa vào diện mạo tổng thể.
Chỉnh sửa được định hướng theo không gian
Flash có thể dùng điểm, khung bao, mũi tên và dấu vẽ tự do để xác định nơi cần sửa. Cung cấp ảnh nguồn cùng vị trí và thay đổi. Với ý tưởng nội thất, đánh dấu ghế, yêu cầu thay vải và xác định sàn, tường, góc máy cùng vật thể lân cận cần giữ. Nếu dấu chỉ dùng để hướng dẫn, yêu cầu rõ việc xoá chúng khỏi ảnh hoàn chỉnh.
Hướng dẫn sửa bằng toạ độ của nhà sản xuất dùng thẻ <point> và <bbox> với toạ độ chuẩn hoá về 0–999 theo ảnh đầu vào xác định. Một điểm chứa x và y; một khung chứa toạ độ góc trên trái và dưới phải. Xác định số thứ tự ảnh và vật thể đích, nhất là khi khung bao gồm nhiều chủ thể. Với chỉnh sửa giữa các ảnh, phân biệt vật thể cần lấy từ một tham chiếu và vùng đích trong ảnh khác.
Dùng kích thước riêng của ảnh đang hiển thị khi lấy vị trí theo tỷ lệ; mức thu phóng, kéo khung vẽ hoặc toạ độ trình duyệt không phải toạ độ ảnh chuẩn hoá. Mô tả vùng được bảo vệ cũng như vùng đã sửa. Đối chiếu phối cảnh, ánh sáng và chi tiết xung quanh của kết quả với nguồn gốc.
Tách bố cục thành các lớp có thể chỉnh sửa
Phân tách lớp là chế độ riêng nhận đúng một ảnh và trả ảnh nền cùng tối đa 16 lớp độc lập. Mỗi lớp là PNG có alpha. Câu lệnh có thể nêu yếu tố cần tách, như tiêu đề, chủ thể chính và trang trí; không có câu lệnh phân tách, mô hình tự xác định yếu tố chính.
Kết quả gồm tên lớp, mô tả, thứ tự xếp chồng và khung vị trí. Dùng ảnh nền có chỉ số xếp chồng bằng không, rồi đặt các lớp khác theo thứ tự xếp chồng tăng dần. Khung tuyệt đối mô tả vị trí trong ảnh nền đầu ra; khung chuẩn hoá mô tả vị trí theo tỷ lệ trên khung vẽ khác. Giữ siêu dữ liệu vị trí trả về cùng tệp ảnh để tái dựng bố cục gốc trước khi sắp xếp lại.
Khi sửa áp phích, tách phần tranh chính khỏi tiêu đề và trang trí, rồi kiểm tra mép cùng mọi vùng nền được phục hồi. Có thể chỉnh sửa lớp trong suốt như đầu vào đơn có kênh alpha, với đầu ra PNG trong suốt. Tuỳ chọn nền trong suốt có phạm vi trong quy trình chỉnh sửa ảnh một đầu vào đó; tạo ảnh từ văn bản thông thường là thao tác riêng.
Bố cục đa ngôn ngữ
Ngoài tiếng Trung và tiếng Anh, nhà sản xuất công bố hỗ trợ gốc câu lệnh và chữ trong ảnh cho tiếng Nga, Ả Rập, Filipino, Thái, Thổ Nhĩ Kỳ, Hàn, Mã Lai, Tây Ban Nha, Bồ Đào Nha, Indonesia, Pháp, Đức, Việt và Nhật. Cung cấp nội dung chính xác đã duyệt cùng hướng đọc, và xác định vùng chứa từng khối chữ. Kiểm tra dấu, ký tự nối, xuống dòng và nhãn nhỏ trong ảnh cuối cùng.
Tệp tham chiếu và thông số đầu ra
Tạo ảnh nhận tối đa 10 tham chiếu ở định dạng JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC hoặc HEIF. Mỗi ảnh tối đa 30 MB, với hai cạnh trên 14 pixel, tổng 196–36,000,000 pixel và tỷ lệ khung hình từ 1:16 đến 16:1. Phân tách lớp thay vào đó yêu cầu một JPEG hoặc PNG có 262,144–36,000,000 pixel, tối đa 30 MB, trong cùng khoảng tỷ lệ.
Tạo ảnh cung cấp các mức đầu ra 1K, 1.5K và 2K, mặc định 2K, hoặc kích thước chỉ định với tổng 921,600–4,624,220 pixel và tỷ lệ từ 1:16 đến 16:1. Cả hai ràng buộc đều áp dụng cho kích thước tuỳ chỉnh. Đầu ra lớp dùng 1K, 1.5K, 2K hoặc auto, mặc định auto; ảnh nền và mỗi lớp giữ tỷ lệ nguồn tương ứng.
Ảnh hoàn chỉnh là JPEG hoặc PNG. Có thể chọn riêng định dạng ảnh nền, còn các lớp phân tách vẫn là PNG có alpha. Bàn giao có thể dùng dữ liệu ảnh đã mã hoá hoặc liên kết tải được lưu 24 giờ. Lưu mọi ảnh trả về và siêu dữ liệu cho quy trình thiết kế dự định. Kiểm tra chữ, chi tiết đã sửa và căn chỉnh lớp ở kích thước tác phẩm sẽ được dùng.
", "aboutText": "Phiên bản tạo ảnh nhanh hơn\n\nSeedream 5.0 Flash là mô hình tạo và chỉnh sửa hình ảnh của ByteDance Seed cho quy trình ưu tiên tốc độ tạo. Hướng dẫn Pro/Flash của nhà sản xuất mô tả cả tạo ảnh từ văn bản lẫn từ ảnh với một hoặc nhiều tham chiếu. Hướng dẫn phân biệt Flash tạo nhanh hơn với Pro ưu tiên chất lượng ảnh cao hơn, nhưng không xác lập thời gian phản hồi cố định cho mọi bản yêu cầu.\n\nCác tính năng chung đặc trưng là chỉnh sửa tương tác, phân tách lớp và tạo ảnh đa ngôn ngữ gốc. Tạo ảnh thông thường trả một ảnh hoàn chỉnh. Quy trình Flash của nhà sản xuất không hỗ trợ tạo chuỗi ảnh liên quan, tìm kiếm web hoặc trả ảnh theo luồng. Tối ưu câu lệnh dùng chế độ standard; tuỳ chọn tối ưu fast riêng thuộc Pro thay vì Flash.\n\nTạo ảnh từ bản yêu cầu và tham chiếu\n\nNêu hình ảnh dự định, chủ thể chính, bố cục và cách thể hiện thị giác, rồi xác định mỗi tham chiếu chi phối gì. Với hình ảnh sản phẩm, tách tham chiếu xác lập vật thể khỏi tham chiếu cung cấp bảng màu hoặc chất liệu bề mặt. “Giữ dáng vật thể và góc nhìn từ ảnh thứ nhất; chỉ dùng ảnh thứ hai cho bảng màu nền dịu” giao vai trò riêng cho tham chiếu.\n\nNhà sản xuất khuyến nghị câu lệnh ngắn gọn, không quá 300 ký tự tiếng Trung hoặc 600 từ tiếng Anh. Đây là hướng dẫn chuẩn bị, không phải ngưỡng cắt cứng đầu vào văn bản được nêu. Liệt kê yêu cầu quyết định trước, gồm nội dung chính xác phải xuất hiện, tỷ lệ khung hình mong muốn và chi tiết phải giữ nguyên. Kiểm tra ảnh hoàn chỉnh theo danh sách đó thay vì chỉ dựa vào diện mạo tổng thể.\n\nChỉnh sửa được định hướng theo không gian\n\nFlash có thể dùng điểm, khung bao, mũi tên và dấu vẽ tự do để xác định nơi cần sửa. Cung cấp ảnh nguồn cùng vị trí và thay đổi. Với ý tưởng nội thất, đánh dấu ghế, yêu cầu thay vải và xác định sàn, tường, góc máy cùng vật thể lân cận cần giữ. Nếu dấu chỉ dùng để hướng dẫn, yêu cầu rõ việc xoá chúng khỏi ảnh hoàn chỉnh.\n\nHướng dẫn sửa bằng toạ độ của nhà sản xuất dùng thẻbytedance-seed/seedream-5-0-flashTạo một hình ảnh hoàn chỉnh từ bản mô tả yêu cầu bằng văn bản.
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.
Phiên bản tạo ảnh nhanh hơn
Seedream 5.0 Flash là mô hình tạo và chỉnh sửa hình ảnh của ByteDance Seed cho quy trình ưu tiên tốc độ tạo. Hướng dẫn Pro/Flash của nhà sản xuất mô tả cả tạo ảnh từ văn bản lẫn từ ảnh với một hoặc nhiều tham chiếu. Hướng dẫn phân biệt Flash tạo nhanh hơn với Pro ưu tiên chất lượng ảnh cao hơn, nhưng không xác lập thời gian phản hồi cố định cho mọi bản yêu cầu.
Các tính năng chung đặc trưng là chỉnh sửa tương tác, phân tách lớp và tạo ảnh đa ngôn ngữ gốc. Tạo ảnh thông thường trả một ảnh hoàn chỉnh. Quy trình Flash của nhà sản xuất không hỗ trợ tạo chuỗi ảnh liên quan, tìm kiếm web hoặc trả ảnh theo luồng. Tối ưu câu lệnh dùng chế độ standard; tuỳ chọn tối ưu fast riêng thuộc Pro thay vì Flash.
Tạo ảnh từ bản yêu cầu và tham chiếu
Nêu hình ảnh dự định, chủ thể chính, bố cục và cách thể hiện thị giác, rồi xác định mỗi tham chiếu chi phối gì. Với hình ảnh sản phẩm, tách tham chiếu xác lập vật thể khỏi tham chiếu cung cấp bảng màu hoặc chất liệu bề mặt. “Giữ dáng vật thể và góc nhìn từ ảnh thứ nhất; chỉ dùng ảnh thứ hai cho bảng màu nền dịu” giao vai trò riêng cho tham chiếu.
Nhà sản xuất khuyến nghị câu lệnh ngắn gọn, không quá 300 ký tự tiếng Trung hoặc 600 từ tiếng Anh. Đây là hướng dẫn chuẩn bị, không phải ngưỡng cắt cứng đầu vào văn bản được nêu. Liệt kê yêu cầu quyết định trước, gồm nội dung chính xác phải xuất hiện, tỷ lệ khung hình mong muốn và chi tiết phải giữ nguyên. Kiểm tra ảnh hoàn chỉnh theo danh sách đó thay vì chỉ dựa vào diện mạo tổng thể.
Chỉnh sửa được định hướng theo không gian
Flash có thể dùng điểm, khung bao, mũi tên và dấu vẽ tự do để xác định nơi cần sửa. Cung cấp ảnh nguồn cùng vị trí và thay đổi. Với ý tưởng nội thất, đánh dấu ghế, yêu cầu thay vải và xác định sàn, tường, góc máy cùng vật thể lân cận cần giữ. Nếu dấu chỉ dùng để hướng dẫn, yêu cầu rõ việc xoá chúng khỏi ảnh hoàn chỉnh.
Hướng dẫn sửa bằng toạ độ của nhà sản xuất dùng thẻ <point> và <bbox> với toạ độ chuẩn hoá về 0–999 theo ảnh đầu vào xác định. Một điểm chứa x và y; một khung chứa toạ độ góc trên trái và dưới phải. Xác định số thứ tự ảnh và vật thể đích, nhất là khi khung bao gồm nhiều chủ thể. Với chỉnh sửa giữa các ảnh, phân biệt vật thể cần lấy từ một tham chiếu và vùng đích trong ảnh khác.
Dùng kích thước riêng của ảnh đang hiển thị khi lấy vị trí theo tỷ lệ; mức thu phóng, kéo khung vẽ hoặc toạ độ trình duyệt không phải toạ độ ảnh chuẩn hoá. Mô tả vùng được bảo vệ cũng như vùng đã sửa. Đối chiếu phối cảnh, ánh sáng và chi tiết xung quanh của kết quả với nguồn gốc.
Tách bố cục thành các lớp có thể chỉnh sửa
Phân tách lớp là chế độ riêng nhận đúng một ảnh và trả ảnh nền cùng tối đa 16 lớp độc lập. Mỗi lớp là PNG có alpha. Câu lệnh có thể nêu yếu tố cần tách, như tiêu đề, chủ thể chính và trang trí; không có câu lệnh phân tách, mô hình tự xác định yếu tố chính.
Kết quả gồm tên lớp, mô tả, thứ tự xếp chồng và khung vị trí. Dùng ảnh nền có chỉ số xếp chồng bằng không, rồi đặt các lớp khác theo thứ tự xếp chồng tăng dần. Khung tuyệt đối mô tả vị trí trong ảnh nền đầu ra; khung chuẩn hoá mô tả vị trí theo tỷ lệ trên khung vẽ khác. Giữ siêu dữ liệu vị trí trả về cùng tệp ảnh để tái dựng bố cục gốc trước khi sắp xếp lại.
Khi sửa áp phích, tách phần tranh chính khỏi tiêu đề và trang trí, rồi kiểm tra mép cùng mọi vùng nền được phục hồi. Có thể chỉnh sửa lớp trong suốt như đầu vào đơn có kênh alpha, với đầu ra PNG trong suốt. Tuỳ chọn nền trong suốt có phạm vi trong quy trình chỉnh sửa ảnh một đầu vào đó; tạo ảnh từ văn bản thông thường là thao tác riêng.
Bố cục đa ngôn ngữ
Ngoài tiếng Trung và tiếng Anh, nhà sản xuất công bố hỗ trợ gốc câu lệnh và chữ trong ảnh cho tiếng Nga, Ả Rập, Filipino, Thái, Thổ Nhĩ Kỳ, Hàn, Mã Lai, Tây Ban Nha, Bồ Đào Nha, Indonesia, Pháp, Đức, Việt và Nhật. Cung cấp nội dung chính xác đã duyệt cùng hướng đọc, và xác định vùng chứa từng khối chữ. Kiểm tra dấu, ký tự nối, xuống dòng và nhãn nhỏ trong ảnh cuối cùng.
Tệp tham chiếu và thông số đầu ra
Tạo ảnh nhận tối đa 10 tham chiếu ở định dạng JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC hoặc HEIF. Mỗi ảnh tối đa 30 MB, với hai cạnh trên 14 pixel, tổng 196–36,000,000 pixel và tỷ lệ khung hình từ 1:16 đến 16:1. Phân tách lớp thay vào đó yêu cầu một JPEG hoặc PNG có 262,144–36,000,000 pixel, tối đa 30 MB, trong cùng khoảng tỷ lệ.
Tạo ảnh cung cấp các mức đầu ra 1K, 1.5K và 2K, mặc định 2K, hoặc kích thước chỉ định với tổng 921,600–4,624,220 pixel và tỷ lệ từ 1:16 đến 16:1. Cả hai ràng buộc đều áp dụng cho kích thước tuỳ chỉnh. Đầu ra lớp dùng 1K, 1.5K, 2K hoặc auto, mặc định auto; ảnh nền và mỗi lớp giữ tỷ lệ nguồn tương ứng.
Ảnh hoàn chỉnh là JPEG hoặc PNG. Có thể chọn riêng định dạng ảnh nền, còn các lớp phân tách vẫn là PNG có alpha. Bàn giao có thể dùng dữ liệu ảnh đã mã hoá hoặc liên kết tải được lưu 24 giờ. Lưu mọi ảnh trả về và siêu dữ liệu cho quy trình thiết kế dự định. Kiểm tra chữ, chi tiết đã sửa và căn chỉnh lớp ở kích thước tác phẩm sẽ được dùng.
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 bytedance-seed/seedream-5-0-flash | 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 Điều kiện: Câu lệnh UTF8 không rỗng. Không tự đặt giới hạn ký tự chung cho toàn bộ sản phẩm của nhà sản xuất. | Mặc định— |
Trườngn | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 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 false | Mặc địnhfalse |
Văn bản thành ảnh · Bắt buộc: prompt
| 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 |
Tham sốoptional | Hợp đồngn, response_format, stream |
Tham sốn | Hợp đồng1 |
Tham sốstream | Hợp đồngfalse |
Tham sốresponse_format | Hợp đồngurl, b64_json |
Tham sốreference_images | Hợp đồngfalse |
Tham sốedit | Hợp đồngfalse |
Tham sốoutput_format_optional | Hợp đồng |
Tham sốresolution_control | Hợp đồngnull |
Tham sốaspect_ratio_control | Hợp đồngnull |
Tham sốother_fields | Hợp đồngbị từ chối, trừ định tuyến nội bộ chính xác của nhà cung cấp đã cố định |
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}
Tạo một ảnh từ câu lệnh.
Lưu mọi mục dữ liệu; url/b64_json là các dạng mã hóa kết quả.
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ìnhảnh đầu vào | Biểu mức phí— | Số lượng dự báo— | Đơn vị tính phímỗi ảnh đầu vào | Phí Đầu vào · ảnh đầu vào · Ước tính chỉ để so sánh $0 mỗi ảnh đầu vào |
| Cấu hìnhUltra | Biểu mức phí— | Số lượng dự báo— | Đơn vị tính phímỗi ảnh đầu ra | Phí Đầu ra · Đầu ra hình ảnh · Ước tính chỉ để so sánh $0.036 mỗi ảnh đầu ra |
| 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.036 ướ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 →
Biểu tham chiếu cấp mô hình không thay đổi việc chọn phương thức, báo giá hoặc khoản phí. Khoản phí đang áp dụng dùng mức phí phương thức Ailoot đã 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 | Điều kiện tính phí | Phí |
|---|---|---|
| Cấu hìnhẢnh đầu ra | Điều kiện tính phíKhông khai báo biến thể giá. | Phí Đầu ra · Ảnh đầu ra $0.036 mỗi ảnh |
| Cấu hìnhẢnh đầu vào | Điều kiện tính phíKhông khai báo biến thể giá. | Phí Đầu vào · Ảnh đầu vào $0 mỗi ảnh |
Các mục niêm yết tương đương mô tả cùng một khoản phí; không cộng thêm phí thứ hai.
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=json.loads('{"model": "bytedance-seed/seedream-5-0-flash", "prompt": "A lighthouse on a cliff, watercolor", "n": 1, "response_format": "b64_json"}')\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\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\nrequest={'model': 'bytedance-seed/seedream-5-0-flash', 'prompt': 'A lighthouse on a cliff, watercolor', 'n': 1, 'response_format': 'b64_json'}\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": "bytedance-seed/seedream-5-0-flash", "prompt": "A lighthouse on a cliff, watercolor", "n": 1, "response_format": "b64_json"};\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 Ultra bytedance-seed/seedream-5-0-flash
Dùng các đường dẫn phương thức hiển thị ở trên.