Wan2.7-Image-Pro là mô hình của Alibaba để tạo ảnh từ văn bản. Thẻ Ailoot hiện tại công bố đầu vào văn bản và kết quả dạng ảnh. Nhà sản xuất còn cung cấp chỉnh sửa, kết hợp ảnh tham chiếu và thay đổi cục bộ; các cách này cần hỗ trợ đầu vào ảnh riêng và không được cung cấp qua phương thức hiện tại của thẻ.
Trong chế độ dùng ảnh tham chiếu của nhà sản xuất, có thể gửi tối đa chín ảnh nguồn và mô tả những yếu tố cần sử dụng từ mỗi ảnh. Khi chỉnh sửa, mô hình giữ đối tượng chính, thay đổi các chi tiết đã chọn hoặc ghép nhiều tư liệu thành bố cục mới. Để định hướng thay đổi chính xác hơn, có thể xác định tối đa hai vùng hình chữ nhật trên một ảnh đầu vào.
Ngoài các chuỗi liên tiếp, có thể đặt bảng màu gồm 3–10 màu. Chế độ suy luận dành cho việc tạo ảnh thông thường từ văn bản, không dùng ảnh tham chiếu hoặc chuỗi liên tiếp: mô hình phân tích trước mô tả của cảnh.
Trong đặc tả Alibaba, đầu ra thông thường gồm từ một đến bốn ảnh. Với chuỗi theo cốt truyện, có thể đặt giới hạn trên tối đa 12 ảnh; mô hình chọn số lượng thực tế theo yêu cầu. Chuỗi có thể sử dụng văn bản và ảnh tham chiếu để giữ các đặc điểm chung của nhân vật và diễn biến câu chuyện liền mạch. Bảng màu và suy luận không được áp dụng ở chế độ này.
Mức 4K được hỗ trợ khi tạo ảnh thông thường từ văn bản, không dùng ảnh tham chiếu hoặc chuỗi liên tiếp. Chỉnh sửa dựa trên ảnh và chuỗi liên tiếp bị giới hạn ở mức 2K. Các ký hiệu này xác định diện tích pixel, không phải độ dài bằng nhau của mỗi cạnh. Có thể chọn tỷ lệ khung hình từ 1:8 đến 8:1; khi chỉnh sửa với độ phân giải đặt sẵn, tỷ lệ khung hình theo ảnh tham chiếu cuối cùng. Kết quả được lưu ở định dạng PNG.
Với những cách sử dụng ảnh đầu vào, Alibaba chấp nhận JPEG, JPG, PNG không có độ trong suốt, BMP và WEBP. Các giới hạn là 20 MB mỗi tệp, từ 240 đến 8000 pixel cho mỗi chiều và tỷ lệ từ 1:8 đến 8:1. Yêu cầu bằng văn bản hỗ trợ tiếng Trung và tiếng Anh; tối đa 5000 ký tự, phần dư bị cắt bỏ. Phiên bản này không có mô tả phủ định hoặc mở rộng yêu cầu. Hạt giống ngẫu nhiên giúp giữ nét tương đồng giữa các phương án, nhưng không bảo đảm lặp lại chính xác.
", "aboutText": "Wan2.7-Image-Pro là mô hình của Alibaba để tạo ảnh từ văn bản. Thẻ Ailoot hiện tại công bố đầu vào văn bản và kết quả dạng ảnh. Nhà sản xuất còn cung cấp chỉnh sửa, kết hợp ảnh tham chiếu và thay đổi cục bộ; các cách này cần hỗ trợ đầu vào ảnh riêng và không được cung cấp qua phương thức hiện tại của thẻ.\n\nTrong chế độ dùng ảnh tham chiếu của nhà sản xuất, có thể gửi tối đa chín ảnh nguồn và mô tả những yếu tố cần sử dụng từ mỗi ảnh. Khi chỉnh sửa, mô hình giữ đối tượng chính, thay đổi các chi tiết đã chọn hoặc ghép nhiều tư liệu thành bố cục mới. Để định hướng thay đổi chính xác hơn, có thể xác định tối đa hai vùng hình chữ nhật trên một ảnh đầu vào.\n\n### Bảng màu và yêu cầu phức tạp\n\nNgoài các chuỗi liên tiếp, có thể đặt bảng màu gồm 3–10 màu. Chế độ suy luận dành cho việc tạo ảnh thông thường từ văn bản, không dùng ảnh tham chiếu hoặc chuỗi liên tiếp: mô hình phân tích trước mô tả của cảnh.\n\nTrong đặc tả Alibaba, đầu ra thông thường gồm từ một đến bốn ảnh. Với chuỗi theo cốt truyện, có thể đặt giới hạn trên tối đa 12 ảnh; mô hình chọn số lượng thực tế theo yêu cầu. Chuỗi có thể sử dụng văn bản và ảnh tham chiếu để giữ các đặc điểm chung của nhân vật và diễn biến câu chuyện liền mạch. Bảng màu và suy luận không được áp dụng ở chế độ này.\n\n### Độ phân giải phụ thuộc vào chế độ\n\nMức 4K được hỗ trợ khi tạo ảnh thông thường từ văn bản, không dùng ảnh tham chiếu hoặc chuỗi liên tiếp. Chỉnh sửa dựa trên ảnh và chuỗi liên tiếp bị giới hạn ở mức 2K. Các ký hiệu này xác định diện tích pixel, không phải độ dài bằng nhau của mỗi cạnh. Có thể chọn tỷ lệ khung hình từ 1:8 đến 8:1; khi chỉnh sửa với độ phân giải đặt sẵn, tỷ lệ khung hình theo ảnh tham chiếu cuối cùng. Kết quả được lưu ở định dạng PNG.\n\nVới những cách sử dụng ảnh đầu vào, Alibaba chấp nhận JPEG, JPG, PNG không có độ trong suốt, BMP và WEBP. Các giới hạn là 20 MB mỗi tệp, từ 240 đến 8000 pixel cho mỗi chiều và tỷ lệ từ 1:8 đến 8:1. Yêu cầu bằng văn bản hỗ trợ tiếng Trung và tiếng Anh; tối đa 5000 ký tự, phần dư bị cắt bỏ. Phiên bản này không có mô tả phủ định hoặc mở rộng yêu cầu. Hạt giống ngẫu nhiên giúp giữ nét tương đồng giữa các phương án, nhưng không bảo đảm lặp lại chính xác.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "96c0a5821084b07c92ae402f36dfb191a4776314d40fb6dfa71e55d3fd726f43", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "vi", "methods": [ { "html": "wan2.7-image-proMô hình tạo ảnh từ yêu cầu bằng văn bản. Nhà sản xuất cho phép điều khiển bảng màu và độ phân giải tối đa 4K khi tạo ảnh thông thường từ 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.
Wan2.7-Image-Pro là mô hình của Alibaba để tạo ảnh từ văn bản. Thẻ Ailoot hiện tại công bố đầu vào văn bản và kết quả dạng ảnh. Nhà sản xuất còn cung cấp chỉnh sửa, kết hợp ảnh tham chiếu và thay đổi cục bộ; các cách này cần hỗ trợ đầu vào ảnh riêng và không được cung cấp qua phương thức hiện tại của thẻ.
Trong chế độ dùng ảnh tham chiếu của nhà sản xuất, có thể gửi tối đa chín ảnh nguồn và mô tả những yếu tố cần sử dụng từ mỗi ảnh. Khi chỉnh sửa, mô hình giữ đối tượng chính, thay đổi các chi tiết đã chọn hoặc ghép nhiều tư liệu thành bố cục mới. Để định hướng thay đổi chính xác hơn, có thể xác định tối đa hai vùng hình chữ nhật trên một ảnh đầu vào.
Ngoài các chuỗi liên tiếp, có thể đặt bảng màu gồm 3–10 màu. Chế độ suy luận dành cho việc tạo ảnh thông thường từ văn bản, không dùng ảnh tham chiếu hoặc chuỗi liên tiếp: mô hình phân tích trước mô tả của cảnh.
Trong đặc tả Alibaba, đầu ra thông thường gồm từ một đến bốn ảnh. Với chuỗi theo cốt truyện, có thể đặt giới hạn trên tối đa 12 ảnh; mô hình chọn số lượng thực tế theo yêu cầu. Chuỗi có thể sử dụng văn bản và ảnh tham chiếu để giữ các đặc điểm chung của nhân vật và diễn biến câu chuyện liền mạch. Bảng màu và suy luận không được áp dụng ở chế độ này.
Mức 4K được hỗ trợ khi tạo ảnh thông thường từ văn bản, không dùng ảnh tham chiếu hoặc chuỗi liên tiếp. Chỉnh sửa dựa trên ảnh và chuỗi liên tiếp bị giới hạn ở mức 2K. Các ký hiệu này xác định diện tích pixel, không phải độ dài bằng nhau của mỗi cạnh. Có thể chọn tỷ lệ khung hình từ 1:8 đến 8:1; khi chỉnh sửa với độ phân giải đặt sẵn, tỷ lệ khung hình theo ảnh tham chiếu cuối cùng. Kết quả được lưu ở định dạng PNG.
Với những cách sử dụng ảnh đầu vào, Alibaba chấp nhận JPEG, JPG, PNG không có độ trong suốt, BMP và WEBP. Các giới hạn là 20 MB mỗi tệp, từ 240 đến 8000 pixel cho mỗi chiều và tỷ lệ từ 1:8 đến 8:1. Yêu cầu bằng văn bản hỗ trợ tiếng Trung và tiếng Anh; tối đa 5000 ký tự, phần dư bị cắt bỏ. Phiên bản này không có mô tả phủ định hoặc mở rộng yêu cầu. Hạt giống ngẫu nhiên giúp giữ nét tương đồng giữa các phương án, nhưng không bảo đảm lặp lại chính xác.
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 wan2.7-image-pro | 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ườ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— |
Trườngimages[].image_url | Loạistring | Yêu cầuKhông hỗ trợ | Giá trị & giới hạn Số byte tối đa sau giải mã: 20.971.520 Loại MIME: image/png, image/jpeg Số ảnh tối đa mỗi mảng: 9 Điều kiện: Một URL thực tế cho mỗi đối tượng images[]. Số phần tử mảng khác với nút lá dạng chuỗi này. Áp dụng khi: Chỉ JSON images/edits; JSON images/generations không phân tích các tham chiếu images. | Mặc định— |
Trườngimage | Loạifile | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Số byte tối đa sau giải mã: 20.971.520 Loại MIME: image/png, image/jpeg Áp dụng khi: tạo bằng multipart/form-data | Mặc định— |
Trườngimage[] | Loạifile[] | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Số mục tối đa: 9 Số byte tối đa sau giải mã: 20.971.520 Loại MIME: image/png, image/jpeg Áp dụng khi: tạo bằng multipart/form-data | Mặc định— |
Văn bản thành ảnh · Bắt buộc: prompt
reference_images_generation · 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 →
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.
| Cấu hình | Điều kiện tính phí | Phí |
|---|---|---|
| Cấu hìnhwan2.7-image-pro · Cấu hình mặc định | Điều kiện tính phíCấu hình mặc định | Phí Đầu vào · Đầu vào 0,00 US$ mỗi lần gọi Đầu ra · Đầu ra 0,16 US$ mỗi lần gọi |
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": "wan2.7-image-pro", "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': 'wan2.7-image-pro', '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": "wan2.7-image-pro", "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 wan2.7-image-pro, wan-image, wan-image-latest
Dùng các đường dẫn phương thức hiển thị ở trên.
wan-imageMô hình tạo ảnh từ yêu cầu bằng văn bản. Nhà sản xuất cho phép điều khiển bảng màu và độ phân giải tối đa 4K khi tạo ảnh thông thường từ 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.
Wan2.7-Image-Pro là mô hình của Alibaba để tạo ảnh từ văn bản. Thẻ Ailoot hiện tại công bố đầu vào văn bản và kết quả dạng ảnh. Nhà sản xuất còn cung cấp chỉnh sửa, kết hợp ảnh tham chiếu và thay đổi cục bộ; các cách này cần hỗ trợ đầu vào ảnh riêng và không được cung cấp qua phương thức hiện tại của thẻ.
Trong chế độ dùng ảnh tham chiếu của nhà sản xuất, có thể gửi tối đa chín ảnh nguồn và mô tả những yếu tố cần sử dụng từ mỗi ảnh. Khi chỉnh sửa, mô hình giữ đối tượng chính, thay đổi các chi tiết đã chọn hoặc ghép nhiều tư liệu thành bố cục mới. Để định hướng thay đổi chính xác hơn, có thể xác định tối đa hai vùng hình chữ nhật trên một ảnh đầu vào.
Ngoài các chuỗi liên tiếp, có thể đặt bảng màu gồm 3–10 màu. Chế độ suy luận dành cho việc tạo ảnh thông thường từ văn bản, không dùng ảnh tham chiếu hoặc chuỗi liên tiếp: mô hình phân tích trước mô tả của cảnh.
Trong đặc tả Alibaba, đầu ra thông thường gồm từ một đến bốn ảnh. Với chuỗi theo cốt truyện, có thể đặt giới hạn trên tối đa 12 ảnh; mô hình chọn số lượng thực tế theo yêu cầu. Chuỗi có thể sử dụng văn bản và ảnh tham chiếu để giữ các đặc điểm chung của nhân vật và diễn biến câu chuyện liền mạch. Bảng màu và suy luận không được áp dụng ở chế độ này.
Mức 4K được hỗ trợ khi tạo ảnh thông thường từ văn bản, không dùng ảnh tham chiếu hoặc chuỗi liên tiếp. Chỉnh sửa dựa trên ảnh và chuỗi liên tiếp bị giới hạn ở mức 2K. Các ký hiệu này xác định diện tích pixel, không phải độ dài bằng nhau của mỗi cạnh. Có thể chọn tỷ lệ khung hình từ 1:8 đến 8:1; khi chỉnh sửa với độ phân giải đặt sẵn, tỷ lệ khung hình theo ảnh tham chiếu cuối cùng. Kết quả được lưu ở định dạng PNG.
Với những cách sử dụng ảnh đầu vào, Alibaba chấp nhận JPEG, JPG, PNG không có độ trong suốt, BMP và WEBP. Các giới hạn là 20 MB mỗi tệp, từ 240 đến 8000 pixel cho mỗi chiều và tỷ lệ từ 1:8 đến 8:1. Yêu cầu bằng văn bản hỗ trợ tiếng Trung và tiếng Anh; tối đa 5000 ký tự, phần dư bị cắt bỏ. Phiên bản này không có mô tả phủ định hoặc mở rộng yêu cầu. Hạt giống ngẫu nhiên giúp giữ nét tương đồng giữa các phương án, nhưng không bảo đảm lặp lại chính xác.
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 wan-image | 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ườ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— |
Trườngimages[].image_url | Loạistring | Yêu cầuKhông hỗ trợ | Giá trị & giới hạn Số byte tối đa sau giải mã: 20.971.520 Loại MIME: image/png, image/jpeg Số ảnh tối đa mỗi mảng: 9 Điều kiện: Một URL thực tế cho mỗi đối tượng images[]. Số phần tử mảng khác với nút lá dạng chuỗi này. Áp dụng khi: Chỉ JSON images/edits; JSON images/generations không phân tích các tham chiếu images. | Mặc định— |
Trườngimage | Loạifile | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Số byte tối đa sau giải mã: 20.971.520 Loại MIME: image/png, image/jpeg Áp dụng khi: tạo bằng multipart/form-data | Mặc định— |
Trườngimage[] | Loạifile[] | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Số mục tối đa: 9 Số byte tối đa sau giải mã: 20.971.520 Loại MIME: image/png, image/jpeg Áp dụng khi: tạo bằng multipart/form-data | Mặc định— |
Văn bản thành ảnh · Bắt buộc: prompt
reference_images_generation · 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 →
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.
| Cấu hình | Điều kiện tính phí | Phí |
|---|---|---|
| Cấu hìnhwan2.7-image-pro · Cấu hình mặc định | Điều kiện tính phíCấu hình mặc định | Phí Đầu vào · Đầu vào 0,00 US$ mỗi lần gọi Đầu ra · Đầu ra 0,16 US$ mỗi lần gọi |
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": "wan-image", "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': 'wan-image', '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": "wan-image", "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 wan2.7-image-pro, wan-image, wan-image-latest
Dùng các đường dẫn phương thức hiển thị ở trên.
wan-image-latestMô hình tạo ảnh từ yêu cầu bằng văn bản. Nhà sản xuất cho phép điều khiển bảng màu và độ phân giải tối đa 4K khi tạo ảnh thông thường từ 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.
Wan2.7-Image-Pro là mô hình của Alibaba để tạo ảnh từ văn bản. Thẻ Ailoot hiện tại công bố đầu vào văn bản và kết quả dạng ảnh. Nhà sản xuất còn cung cấp chỉnh sửa, kết hợp ảnh tham chiếu và thay đổi cục bộ; các cách này cần hỗ trợ đầu vào ảnh riêng và không được cung cấp qua phương thức hiện tại của thẻ.
Trong chế độ dùng ảnh tham chiếu của nhà sản xuất, có thể gửi tối đa chín ảnh nguồn và mô tả những yếu tố cần sử dụng từ mỗi ảnh. Khi chỉnh sửa, mô hình giữ đối tượng chính, thay đổi các chi tiết đã chọn hoặc ghép nhiều tư liệu thành bố cục mới. Để định hướng thay đổi chính xác hơn, có thể xác định tối đa hai vùng hình chữ nhật trên một ảnh đầu vào.
Ngoài các chuỗi liên tiếp, có thể đặt bảng màu gồm 3–10 màu. Chế độ suy luận dành cho việc tạo ảnh thông thường từ văn bản, không dùng ảnh tham chiếu hoặc chuỗi liên tiếp: mô hình phân tích trước mô tả của cảnh.
Trong đặc tả Alibaba, đầu ra thông thường gồm từ một đến bốn ảnh. Với chuỗi theo cốt truyện, có thể đặt giới hạn trên tối đa 12 ảnh; mô hình chọn số lượng thực tế theo yêu cầu. Chuỗi có thể sử dụng văn bản và ảnh tham chiếu để giữ các đặc điểm chung của nhân vật và diễn biến câu chuyện liền mạch. Bảng màu và suy luận không được áp dụng ở chế độ này.
Mức 4K được hỗ trợ khi tạo ảnh thông thường từ văn bản, không dùng ảnh tham chiếu hoặc chuỗi liên tiếp. Chỉnh sửa dựa trên ảnh và chuỗi liên tiếp bị giới hạn ở mức 2K. Các ký hiệu này xác định diện tích pixel, không phải độ dài bằng nhau của mỗi cạnh. Có thể chọn tỷ lệ khung hình từ 1:8 đến 8:1; khi chỉnh sửa với độ phân giải đặt sẵn, tỷ lệ khung hình theo ảnh tham chiếu cuối cùng. Kết quả được lưu ở định dạng PNG.
Với những cách sử dụng ảnh đầu vào, Alibaba chấp nhận JPEG, JPG, PNG không có độ trong suốt, BMP và WEBP. Các giới hạn là 20 MB mỗi tệp, từ 240 đến 8000 pixel cho mỗi chiều và tỷ lệ từ 1:8 đến 8:1. Yêu cầu bằng văn bản hỗ trợ tiếng Trung và tiếng Anh; tối đa 5000 ký tự, phần dư bị cắt bỏ. Phiên bản này không có mô tả phủ định hoặc mở rộng yêu cầu. Hạt giống ngẫu nhiên giúp giữ nét tương đồng giữa các phương án, nhưng không bảo đảm lặp lại chính xác.
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 wan-image-latest | 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ườ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— |
Trườngimages[].image_url | Loạistring | Yêu cầuKhông hỗ trợ | Giá trị & giới hạn Số byte tối đa sau giải mã: 20.971.520 Loại MIME: image/png, image/jpeg Số ảnh tối đa mỗi mảng: 9 Điều kiện: Một URL thực tế cho mỗi đối tượng images[]. Số phần tử mảng khác với nút lá dạng chuỗi này. Áp dụng khi: Chỉ JSON images/edits; JSON images/generations không phân tích các tham chiếu images. | Mặc định— |
Trườngimage | Loạifile | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Số byte tối đa sau giải mã: 20.971.520 Loại MIME: image/png, image/jpeg Áp dụng khi: tạo bằng multipart/form-data | Mặc định— |
Trườngimage[] | Loạifile[] | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Số mục tối đa: 9 Số byte tối đa sau giải mã: 20.971.520 Loại MIME: image/png, image/jpeg Áp dụng khi: tạo bằng multipart/form-data | Mặc định— |
Văn bản thành ảnh · Bắt buộc: prompt
reference_images_generation · 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 →
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.
| Cấu hình | Điều kiện tính phí | Phí |
|---|---|---|
| Cấu hìnhwan2.7-image-pro · Cấu hình mặc định | Điều kiện tính phíCấu hình mặc định | Phí Đầu vào · Đầu vào 0,00 US$ mỗi lần gọi Đầu ra · Đầu ra 0,16 US$ mỗi lần gọi |
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": "wan-image-latest", "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': 'wan-image-latest', '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": "wan-image-latest", "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 wan2.7-image-pro, wan-image, wan-image-latest
Dùng các đường dẫn phương thức hiển thị ở trên.