Wan2.7-Image создаёт изображения по текстовому заданию. В текущей карточке Ailoot представлен именно текстовый вход и результат в виде изображения. По данным Alibaba, эта версия ориентирована на более быстрое получение вариантов. В спецификации производителя также предусмотрены редактирование, сочетание референсов и локальные изменения; они требуют отдельной поддержки входных изображений, которая не представлена текущим методом карточки.
Для режима с референсами Alibaba предусматривает до девяти исходных изображений в задании. Они служат опорами для внешности объекта, композиции и деталей. Модель может объединять несколько материалов в новую сцену или изменять исходную картинку с сохранением главного предмета. Для точечного редактирования предусмотрены явно обозначенные области: на одном изображении можно указать до двух прямоугольных участков.
В спецификации Alibaba обычный режим формирует от одного до четырёх результатов. Последовательная серия позволяет запросить до 12 изображений, связанных историей или общими чертами персонажей. Для серии это верхняя граница: модель сама определяет необходимое число кадров и может вернуть меньше. Задание и исходные материалы помогают удерживать общую сюжетную линию.
Для обычной генерации по тексту без референсов и последовательной серии предусмотрен режим рассуждения. В нём модель подробнее анализирует сложное описание перед созданием изображения. При редактировании по картинкам и в последовательной серии этот режим не применяется. Заданная палитра из 3–10 цветов доступна вне последовательных серий.
В режимах с исходными изображениями у производителя поддерживаются JPEG, JPG, PNG без прозрачности, BMP и WEBP. Каждая сторона может содержать от 240 до 8000 пикселей, размер файла — до 20 МБ, соотношение сторон — от 1:8 до 8:1.
Текстовое задание поддерживает китайский и английский языки и ограничено 5000 символами; избыточная часть отбрасывается. Для этой версии не предусмотрены отрицательное описание и дополнительное расширение задания.
Выходной формат — PNG, разрешение — до уровня 2K. Обозначение относится к общей площади пикселей, а не к фиксированной максимальной длине стороны; форму можно выбирать в пределах от 1:8 до 8:1. При редактировании с предустановленным разрешением результат сохраняет соотношение сторон последнего референса. Одинаковое начальное зерно случайности помогает получить похожие варианты, но не гарантирует полного совпадения.
", "aboutText": "Wan2.7-Image создаёт изображения по текстовому заданию. В текущей карточке Ailoot представлен именно текстовый вход и результат в виде изображения. По данным Alibaba, эта версия ориентирована на более быстрое получение вариантов. В спецификации производителя также предусмотрены редактирование, сочетание референсов и локальные изменения; они требуют отдельной поддержки входных изображений, которая не представлена текущим методом карточки.\n\n### Режимы, описанные Alibaba\n\nДля режима с референсами Alibaba предусматривает до девяти исходных изображений в задании. Они служат опорами для внешности объекта, композиции и деталей. Модель может объединять несколько материалов в новую сцену или изменять исходную картинку с сохранением главного предмета. Для точечного редактирования предусмотрены явно обозначенные области: на одном изображении можно указать до двух прямоугольных участков.\n\nВ спецификации Alibaba обычный режим формирует от одного до четырёх результатов. Последовательная серия позволяет запросить до 12 изображений, связанных историей или общими чертами персонажей. Для серии это верхняя граница: модель сама определяет необходимое число кадров и может вернуть меньше. Задание и исходные материалы помогают удерживать общую сюжетную линию.\n\nДля обычной генерации по тексту без референсов и последовательной серии предусмотрен режим рассуждения. В нём модель подробнее анализирует сложное описание перед созданием изображения. При редактировании по картинкам и в последовательной серии этот режим не применяется. Заданная палитра из 3–10 цветов доступна вне последовательных серий.\n\n### Вход и результат\n\nВ режимах с исходными изображениями у производителя поддерживаются JPEG, JPG, PNG без прозрачности, BMP и WEBP. Каждая сторона может содержать от 240 до 8000 пикселей, размер файла — до 20 МБ, соотношение сторон — от 1:8 до 8:1.\n\nТекстовое задание поддерживает китайский и английский языки и ограничено 5000 символами; избыточная часть отбрасывается. Для этой версии не предусмотрены отрицательное описание и дополнительное расширение задания.\n\nВыходной формат — PNG, разрешение — до уровня 2K. Обозначение относится к общей площади пикселей, а не к фиксированной максимальной длине стороны; форму можно выбирать в пределах от 1:8 до 8:1. При редактировании с предустановленным разрешением результат сохраняет соотношение сторон последнего референса. Одинаковое начальное зерно случайности помогает получить похожие варианты, но не гарантирует полного совпадения.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "281a0c6ebdd161bf61bb19c4feafb0898cc343fb37c33f6a134e172308cecfe2", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ru", "methods": [ { "html": "wan2.7-imageМодель генерации изображений по тексту для подготовки дизайн-вариантов и иллюстраций. По данным Alibaba, эта версия ориентирована на более быстрое создание изображений.
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
Wan2.7-Image создаёт изображения по текстовому заданию. В текущей карточке Ailoot представлен именно текстовый вход и результат в виде изображения. По данным Alibaba, эта версия ориентирована на более быстрое получение вариантов. В спецификации производителя также предусмотрены редактирование, сочетание референсов и локальные изменения; они требуют отдельной поддержки входных изображений, которая не представлена текущим методом карточки.
Для режима с референсами Alibaba предусматривает до девяти исходных изображений в задании. Они служат опорами для внешности объекта, композиции и деталей. Модель может объединять несколько материалов в новую сцену или изменять исходную картинку с сохранением главного предмета. Для точечного редактирования предусмотрены явно обозначенные области: на одном изображении можно указать до двух прямоугольных участков.
В спецификации Alibaba обычный режим формирует от одного до четырёх результатов. Последовательная серия позволяет запросить до 12 изображений, связанных историей или общими чертами персонажей. Для серии это верхняя граница: модель сама определяет необходимое число кадров и может вернуть меньше. Задание и исходные материалы помогают удерживать общую сюжетную линию.
Для обычной генерации по тексту без референсов и последовательной серии предусмотрен режим рассуждения. В нём модель подробнее анализирует сложное описание перед созданием изображения. При редактировании по картинкам и в последовательной серии этот режим не применяется. Заданная палитра из 3–10 цветов доступна вне последовательных серий.
В режимах с исходными изображениями у производителя поддерживаются JPEG, JPG, PNG без прозрачности, BMP и WEBP. Каждая сторона может содержать от 240 до 8000 пикселей, размер файла — до 20 МБ, соотношение сторон — от 1:8 до 8:1.
Текстовое задание поддерживает китайский и английский языки и ограничено 5000 символами; избыточная часть отбрасывается. Для этой версии не предусмотрены отрицательное описание и дополнительное расширение задания.
Выходной формат — PNG, разрешение — до уровня 2K. Обозначение относится к общей площади пикселей, а не к фиксированной максимальной длине стороны; форму можно выбирать в пределах от 1:8 до 8:1. При редактировании с предустановленным разрешением результат сохраняет соотношение сторон последнего референса. Одинаковое начальное зерно случайности помогает получить похожие варианты, но не гарантирует полного совпадения.
POST /v1/images/generationstextimage| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения wan2.7-image | По умолчанию— |
Полеprompt | Типstring | ТребованиеОбязательно | Значения и ограничения Минимальная длина: 1 | По умолчанию— |
Полеn | Типinteger | ТребованиеНеобязательно | Значения и ограничения Минимум: 1 | По умолчанию1 |
Полеresponse_format | Типstring | ТребованиеНеобязательно | Значения и ограничения url, b64_json | По умолчанию— |
Полеstream | Типboolean | ТребованиеНеобязательно | Значения и ограничения | По умолчаниюfalse |
Полеsize | Типstring | ТребованиеНеобязательно | Значения и ограничения Зависит от модели | По умолчанию— |
Полеpartial_images | Типinteger | ТребованиеНеобязательно | Значения и ограничения Зависит от модели | По умолчанию— |
Полеimages[].image_url | Типstring | ТребованиеНе поддерживается | Значения и ограничения Максимум декодированных байтов: 20 971 520 Типы MIME: image/png, image/jpeg Максимум изображений в массиве: 9 Условия: Один фактический URL на объект images[]. Количество элементов массива не относится к этому строковому полю. Применяется, когда: Только JSON images/edits; JSON images/generations не разбирает референсы изображений. | По умолчанию— |
Полеimage | Типfile | ТребованиеНеобязательно | Значения и ограничения Максимум декодированных байтов: 20 971 520 Типы MIME: image/png, image/jpeg Применяется, когда: генерация с multipart/form-data | По умолчанию— |
Полеimage[] | Типfile[] | ТребованиеНеобязательно | Значения и ограничения Максимум элементов: 9 Максимум декодированных байтов: 20 971 520 Типы MIME: image/png, image/jpeg Применяется, когда: генерация с multipart/form-data | По умолчанию— |
Из текста в изображение · Обязательно: prompt
reference_images_generation · Обязательно: prompt
| Параметр | Контракт |
|---|---|
Параметрmaterial_types | Контрактtext |
Параметрrequired | Контрактmodel, prompt |
Параметрoptional_controls | Контрактnull |
Параметрcontent_type | Контрактapplication/json |
Жизненный цикл: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Фактически возвращённый task_id или запись в медиатеке
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Структуры методов и ID указаны точно; возможности поставщика рассматриваются отдельно от допуска.
POST /v1/images/generationsAiloot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Справочные шкалы модели не меняют выбор метода, расчёт стоимости или списания. Действующая плата определяется ставками выбранного метода Ailoot.
| Конфигурация | Условия расчёта | Плата |
|---|---|---|
| Конфигурацияwan2.7-image · Стандартная конфигурация | Условия расчётаКонфигурация по умолчанию | Плата Вход · Вход 0,00 $ за вызов Выход · Выход 0,06 $ за вызов |
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\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', '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", "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Загрузите каждое полученное изображение или сохраните его содержимое Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Сохраните каждое готовое изображение; загрузите содержимое по каждому полученному URL или декодируйте его содержимое Base64.
Сохраняйте каждый элемент данных. Декодируйте каждый b64_json или загружайте ресурс по каждому возвращённому подписанному URL. Выбирайте расширение имени файла по фактическому MIME и байтам.
Если результат генерации или редактирования изображения требует проверки, сохраните исходный operation_id/X-Client-Request-ID и возвращённые сведения о результате. Восстановите существующие собственные результаты через медиатеку, используя фактические значения task_id или asset_id. Не отправляйте запрос генерации или редактирования повторно и не составляйте URL опроса из operation_id.
| Поле | Тип |
|---|---|
Полеcreated | Типinteger |
Полеdata[].url | Типstring |
Полеdata[].b64_json | Типbase64 string |
Полеusage | Типobject |
| Ответ | Условие | Следующий шаг |
|---|---|---|
Ответ400 · invalid_request_error | УсловиеНеверные обязательные поля, представление материалов или значение параметра | Следующий шагИсправьте указанные поля перед новым запросом на создание. |
Ответserver_error | УсловиеВозвращённый ответ указывает, что операция или результат требуют проверки | Следующий шагСохраните исходный возвращённый ID операции или задачи, заголовки запроса и ответ; продолжайте поддерживаемые операции чтения исходной операции. Не отправляйте запрос создания повторно. |
Ailoot wan2.7-image
Используйте пути методов, указанные выше.