{ "aboutHtml": "

Wan2.7-Image tạo ảnh từ yêu cầu bằng văn bản. Thẻ Ailoot hiện tại giới thiệu đúng loại đầu vào văn bản này và kết quả dạng ảnh. Theo Alibaba, phiên bản này hướng tới việc tạo các phương án nhanh hơn. Đặc tả của nhà sản xuất còn có 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, chưa được cung cấp qua phương thức hiện tại của thẻ.

Các chế độ được Alibaba mô tả

Với chế độ dùng ảnh tham chiếu, Alibaba cho phép tối đa chín ảnh nguồn trong một yêu cầu. Chúng là cơ sở cho diện mạo đối tượng, bố cục và chi tiết. Mô hình có thể kết hợp nhiều tư liệu thành cảnh mới hoặc thay đổi ảnh nguồn trong khi giữ đối tượng chính. Để chỉnh sửa từng phần, có thể chỉ rõ các vùng: trên một ảnh được phép xác định tối đa hai vùng hình chữ nhật.

Trong đặc tả Alibaba, chế độ thông thường tạo từ một đến bốn kết quả. Chuỗi liên tiếp cho phép yêu cầu tối đa 12 ảnh liên kết bằng câu chuyện hoặc những đặc điểm chung của nhân vật. Đây là giới hạn trên của chuỗi: mô hình tự xác định số khung hình cần thiết và có thể trả về ít hơn. Yêu cầu và tư liệu nguồn giúp giữ mạch truyện chung.

Có chế độ suy luận 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. Ở chế độ này, mô hình phân tích mô tả phức tạp kỹ hơn trước khi tạo ảnh. Khi chỉnh sửa dựa trên ảnh và trong chuỗi liên tiếp, chế độ này không được áp dụng. Có thể đặt bảng màu gồm 3–10 màu ngoài các chuỗi liên tiếp.

Đầu vào và kết quả

Trong các chế độ dùng ảnh nguồn của nhà sản xuất, các định dạng được hỗ trợ là JPEG, JPG, PNG không có độ trong suốt, BMP và WEBP. Mỗi chiều có thể từ 240 đến 8000 pixel, dung lượng tệp tối đa 20 MB, tỷ lệ khung hình 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, giới hạn 5000 ký tự; phần vượt giới hạn bị cắt bỏ. Phiên bản này không có mô tả phủ định hoặc tính năng mở rộng yêu cầu bổ sung.

Định dạng đầu ra là PNG, độ phân giải tối đa ở mức 2K. Ký hiệu này chỉ tổng diện tích pixel, không phải độ dài cạnh tối đa cố định; hình dạng có thể được chọn trong phạm vi từ 1:8 đến 8:1. Khi chỉnh sửa với độ phân giải đặt sẵn, kết quả giữ tỷ lệ khung hình của ảnh tham chiếu cuối cùng. Cùng một hạt giống ngẫu nhiên giúp tạo các phương án tương tự, nhưng không bảo đảm trùng khớp hoàn toàn.

", "aboutText": "Wan2.7-Image tạo ảnh từ yêu cầu bằng văn bản. Thẻ Ailoot hiện tại giới thiệu đúng loại đầu vào văn bản này và kết quả dạng ảnh. Theo Alibaba, phiên bản này hướng tới việc tạo các phương án nhanh hơn. Đặc tả của nhà sản xuất còn có 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, chưa được cung cấp qua phương thức hiện tại của thẻ.\n\n### Các chế độ được Alibaba mô tả\n\nVới chế độ dùng ảnh tham chiếu, Alibaba cho phép tối đa chín ảnh nguồn trong một yêu cầu. Chúng là cơ sở cho diện mạo đối tượng, bố cục và chi tiết. Mô hình có thể kết hợp nhiều tư liệu thành cảnh mới hoặc thay đổi ảnh nguồn trong khi giữ đối tượng chính. Để chỉnh sửa từng phần, có thể chỉ rõ các vùng: trên một ảnh được phép xác định tối đa hai vùng hình chữ nhật.\n\nTrong đặc tả Alibaba, chế độ thông thường tạo từ một đến bốn kết quả. Chuỗi liên tiếp cho phép yêu cầu tối đa 12 ảnh liên kết bằng câu chuyện hoặc những đặc điểm chung của nhân vật. Đây là giới hạn trên của chuỗi: mô hình tự xác định số khung hình cần thiết và có thể trả về ít hơn. Yêu cầu và tư liệu nguồn giúp giữ mạch truyện chung.\n\nCó chế độ suy luận 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. Ở chế độ này, mô hình phân tích mô tả phức tạp kỹ hơn trước khi tạo ảnh. Khi chỉnh sửa dựa trên ảnh và trong chuỗi liên tiếp, chế độ này không được áp dụng. Có thể đặt bảng màu gồm 3–10 màu ngoài các chuỗi liên tiếp.\n\n### Đầu vào và kết quả\n\nTrong các chế độ dùng ảnh nguồn của nhà sản xuất, các định dạng được hỗ trợ là JPEG, JPG, PNG không có độ trong suốt, BMP và WEBP. Mỗi chiều có thể từ 240 đến 8000 pixel, dung lượng tệp tối đa 20 MB, tỷ lệ khung hình từ 1:8 đến 8:1.\n\nYêu cầu bằng văn bản hỗ trợ tiếng Trung và tiếng Anh, giới hạn 5000 ký tự; phần vượt giới hạn bị cắt bỏ. Phiên bản này không có mô tả phủ định hoặc tính năng mở rộng yêu cầu bổ sung.\n\nĐịnh dạng đầu ra là PNG, độ phân giải tối đa ở mức 2K. Ký hiệu này chỉ tổng diện tích pixel, không phải độ dài cạnh tối đa cố định; hình dạng có thể được chọn trong phạm vi từ 1:8 đến 8:1. Khi chỉnh sửa với độ phân giải đặt sẵn, kết quả giữ tỷ lệ khung hình của ảnh tham chiếu cuối cùng. Cùng một hạt giống ngẫu nhiên giúp tạo các phương án tương tự, nhưng không bảo đảm trùng khớp hoàn toàn.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "ed75e3f888c7fcc23abe7ffbb595235d954a8d4a7d181d12c6c3965a7a6d15be", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "vi", "methods": [ { "html": "

Al

wan2.7-image

Alibaba /wan2.7-image

Bắt đầu

Mô hình tạo ảnh từ văn bản để chuẩn bị các phương án thiết kế và hình minh họa. Theo Alibaba, phiên bản này hướng tới việc tạo ảnh nhanh hơn.

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

Về mô hình

Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.

Wan2.7-Image tạo ảnh từ yêu cầu bằng văn bản. Thẻ Ailoot hiện tại giới thiệu đúng loại đầu vào văn bản này và kết quả dạng ảnh. Theo Alibaba, phiên bản này hướng tới việc tạo các phương án nhanh hơn. Đặc tả của nhà sản xuất còn có 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, chưa được cung cấp qua phương thức hiện tại của thẻ.

Các chế độ được Alibaba mô tả

Với chế độ dùng ảnh tham chiếu, Alibaba cho phép tối đa chín ảnh nguồn trong một yêu cầu. Chúng là cơ sở cho diện mạo đối tượng, bố cục và chi tiết. Mô hình có thể kết hợp nhiều tư liệu thành cảnh mới hoặc thay đổi ảnh nguồn trong khi giữ đối tượng chính. Để chỉnh sửa từng phần, có thể chỉ rõ các vùng: trên một ảnh được phép xác định tối đa hai vùng hình chữ nhật.

Trong đặc tả Alibaba, chế độ thông thường tạo từ một đến bốn kết quả. Chuỗi liên tiếp cho phép yêu cầu tối đa 12 ảnh liên kết bằng câu chuyện hoặc những đặc điểm chung của nhân vật. Đây là giới hạn trên của chuỗi: mô hình tự xác định số khung hình cần thiết và có thể trả về ít hơn. Yêu cầu và tư liệu nguồn giúp giữ mạch truyện chung.

Có chế độ suy luận 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. Ở chế độ này, mô hình phân tích mô tả phức tạp kỹ hơn trước khi tạo ảnh. Khi chỉnh sửa dựa trên ảnh và trong chuỗi liên tiếp, chế độ này không được áp dụng. Có thể đặt bảng màu gồm 3–10 màu ngoài các chuỗi liên tiếp.

Đầu vào và kết quả

Trong các chế độ dùng ảnh nguồn của nhà sản xuất, các định dạng được hỗ trợ là JPEG, JPG, PNG không có độ trong suốt, BMP và WEBP. Mỗi chiều có thể từ 240 đến 8000 pixel, dung lượng tệp tối đa 20 MB, tỷ lệ khung hình 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, giới hạn 5000 ký tự; phần vượt giới hạn bị cắt bỏ. Phiên bản này không có mô tả phủ định hoặc tính năng mở rộng yêu cầu bổ sung.

Định dạng đầu ra là PNG, độ phân giải tối đa ở mức 2K. Ký hiệu này chỉ tổng diện tích pixel, không phải độ dài cạnh tối đa cố định; hình dạng có thể được chọn trong phạm vi từ 1:8 đến 8:1. Khi chỉnh sửa với độ phân giải đặt sẵn, kết quả giữ tỷ lệ khung hình của ảnh tham chiếu cuối cùng. Cùng một hạt giống ngẫu nhiên giúp tạo các phương án tương tự, nhưng không bảo đảm trùng khớp hoàn toàn.

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

Ailoot · Ảnh POST /v1/images/generations

Đầu vào: text
Đầu ra: image
Định dạng đầu ra: Tệp ảnh

Trường	Loại	Yêu cầu	Giá trị & giới hạn	Mặc định
Trường`model`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn wan2.7-image	Mặc định—
Trường`prompt`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn Độ dài tối thiểu: 1	Mặc định—
Trường`n`	Loại`integer`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn Tối thiểu: 1	Mặc định1
Trường`response_format`	Loại`string`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn url, b64_json	Mặc định—
Trường`stream`	Loại`boolean`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn	Mặc địnhfalse
Trường`size`	Loại`string`	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ường`partial_images`	Loại`integer`	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ường`images[].image_url`	Loại`string`	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ường`image`	Loại`file`	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ường`image[]`	Loại`file[]`	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—

Tổ hợp tư liệu đầu vào

Văn bản thành ảnh · Bắt buộc: prompt

reference_images_generation · Bắt buộc: prompt

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

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.

Bảng giá

Mức phí phương thức Ailoot

Ailoot ẢnhPOST /v1/images/generations

Đầu ra: 0,03 US$ mỗi ảnh 1K
Đầu ra: 0,03 US$ mỗi ảnh 2K

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 →

Chi tiết giá cước tham chiếu

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.

wan2.7-image

Giá theo cấu hình

Cấu hình	Điều kiện tính phí	Phí
Cấu hìnhwan2.7-image · 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,06 US$ mỗi lần gọi

Ví dụ yêu cầu

Ailoot · Ảnh

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

from 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', '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])\n

import 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", "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");\n

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

Ailoot · Ảnh

Tả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}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

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

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

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 phản hồi

Trường	Loại
Trường`created`	Loạiinteger
Trường`data[].url`	Loạistring
Trường`data[].b64_json`	Loạibase64 string
Trường`usage`	Loạiobject

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

Phản hồi	Điều kiện	Bước tiếp theo
Phản hồi400 · `invalid_request_error`	Điều kiệ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ồi`server_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.

Bí danh

Bí danh mô hình

Ailoot wan2.7-image

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

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

ID gọi liên quan

", "method_identity": { "effective_request_model_id": "wan2.7-image", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "wan2.7-image", "route_label": "Core" }, "method_key": "Core|images|/v1/images/generations|wan2.7-image", "ordinal": 0, "rawMethod": { "cache_read": null, "cache_write": null, "cache_write_1h": null, "cache_write_5m": null, "conditional_meter": null, "contract": { "data": { "all_results": "Save every data item. Decode each b64_json or fetch every returned signed URL. Select a filename extension from the actual MIME/bytes.", "errors": [ { "code": null, "condition": "Trườ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ệ", "http_status": 400, "recovery": "Sửa các trường được chỉ ra trước khi gửi yêu cầu tạo mới.", "type": "invalid_request_error" }, { "code": null, "condition": "Phản hồi trả về cho biết thao tác hoặc kết quả cần được kiểm tra", "http_status": null, "recovery": "Giữ 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.", "type": "server_error" } ], "hints": [ "Qwen defaultsize1024*1024; Wan defaultsize1K. Wan2.7 Pro4K is supported only without reference inputs.", "Explicit dimensions must be positive, at most4096 peraxis, within8:1..1:8 aspect, and the exact model/input area range.", "The Alibaba image adapter rejects mask input and streaming before sending the request.", "For this generation method, actual image references are supported as multipart image files. JSONimages[].image_url is read only on images/edits; the leaf value is a string." ], "ignored_fields": [ "quality", "background", "style", "output_format", "output_compression", "moderation", "input_fidelity", "partial_images without streaming" ], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "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." }, "material_combinations": [ { "content_type": "application/json", "ignored_reference_field": "JSONgeneration images[] is not parsed; images[].image_url belongs to a separately supported JSONedit profile.", "mask": false, "mode": "text_to_image", "reference_images": false, "required": [ "prompt" ], "supplied_materials": [ "UTF8 prompt" ] }, { "content_type": "multipart/form-data", "mask": false, "maximum_decoded_bytes_per_image": 20971520, "maximum_reference_images": 9, "mime_types": [ "image/png", "image/jpeg" ], "minimum_reference_images": 0, "mode": "reference_images_generation", "optional_file_fields": [ "image", "image[]", "image[index]" ], "reference_images": true, "required": [ "prompt" ], "supplied_materials": [ "UTF8 prompt", "actual PNG/JPEG file references" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_image", "reference_images_generation_via_multipart" ], "outputs": { "all_results": "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ế.", "family": "image", "fields": [ { "description": null, "name": "created", "type": "integer" }, { "description": null, "name": "data[].url", "type": "string" }, { "description": null, "name": "data[].b64_json", "type": "base64 string" }, { "description": null, "name": "usage", "type": "object" } ], "format": "actual validated raster MIME" }, "parameter_conditions": { "size": { "aspect_ratio_range": [ "1:8", "8:1" ], "default": "1K", "max_area_4k_condition": "WanPro and no inputimages", "max_dimension": 4096, "maximum_area": 4194304, "minimum_area": 589824 } }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "wan2.7-image" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "enum": null, "enum_known": false, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "url", "b64_json" ], "enum_known": true, "name": "response_format", "required": false, "type": "string" }, { "availability": "source_interface", "default": false, "default_known": true, "enum": null, "enum_known": false, "name": "stream", "required": false, "type": "boolean" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "size", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "partial_images", "required": false, "type": "integer" }, { "availability": "different_method", "conditions": "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.", "decoded_max_bytes": 20971520, "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum_images_per_array": 9, "mime_types": [ "image/png", "image/jpeg" ], "name": "images[].image_url", "required": false, "type": "string", "when": "Chỉ JSON images/edits; JSON images/generations không phân tích các tham chiếu images." }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum_decoded_bytes": 20971520, "mime_types": [ "image/png", "image/jpeg" ], "name": "image", "required": false, "type": "file", "when": "tạo bằng multipart/form-data" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum_decoded_bytes": 20971520, "maximum_items": 9, "mime_types": [ "image/png", "image/jpeg" ], "name": "image[]", "required": false, "type": "file[]", "when": "tạo bằng multipart/form-data" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [ "images[].file_id", "mask.file_id", "mask", "stream=true", "mask input is rejected by this Alibaba adapter" ] }, "hints": [ "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." ], "input": { "content_type": "application/json", "material_types": [ "text" ], "optional_controls": null, "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "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", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "If an image generation or edit result requires a check, keep the original operation_id/X-Client-Request-ID and returned result information. Recover existing owned results through the media library using actual task_id or asset_id values. Do not resubmit the generation/edit request or construct a polling URL from operation_id." }, "method": { "http": "POST", "path": "/v1/images/generations" }, "operation_modes": [ "images" ], "output": { "family": [ "image" ], "format": null, "multioutputs": "retain every actual response output" } }, "ctx": null, "examples": [ { "code": "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\", \"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\"