Wan 2.5 — 创建任务

POST

/services/aigc/image2image/image-synthesis

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
  -H 'X-DashScope-Async: enable' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "wan2.5-i2i-preview",
  "input": {
    "prompt": "Change the floral dress to a vintage-style lace long dress with exquisite embroidery details on the collar and cuffs.",
    "images": [
      "https://img.alicdn.com/imgextra/i2/O1CN01vHOj4h28jOxUJPwY8_!!6000000007968-49-tps-1344-896.webp"
    ]
  },
  "parameters": {
    "prompt_extend": true,
    "n": 1
  }
}'

{
  "output": {
    "task_status": "PENDING",
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
  },
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

请先获取 API Key 并设置为环境变量。如需使用 SDK，请先安装 SDK。

通过文本提示词编辑图像，同时保持主体一致性。支持多图融合，最多可使用三张参考图像。

鉴权

string

header

必填

千问云 API Key。详见获取 API Key。

Header 参数

enum<string>

默认值"enable"

必填

开启异步处理模式，必须设置为 enable。HTTP 请求仅支持异步处理。省略此请求头将返回 "current user api does not support synchronous calls" 错误。

可选值：enable

请求体

application/json

enum<string>

必填

模型名称。

可选值：wan2.5-i2i-preview

示例:wan2.5-i2i-preview

object

必填

图像编辑的输入数据。

显示子属性

string

必填

正向提示词，描述生成图像中需要包含的元素和视觉特征。支持中英文。最多 2,000 个字符，超出部分将被截断。

示例:Change the floral dress to a vintage-style lace long dress with exquisite embroidery details on the collar and cuffs.

string[]

必填

输入图像 URL 数组。每次请求最多支持 3 张图像。多张图像时，数组顺序定义图像序号（图像 1、图像 2 等）。

图像限制：

支持格式：JPEG、JPG、PNG、BMP 和 WEBP。PNG alpha 通道将被忽略。
分辨率：宽和高均须在 384 到 5,000 像素之间。
最大文件大小：10 MB。

支持的输入格式：

公开 URL：支持 HTTP 和 HTTPS。
Base64 编码字符串：格式：data:{MIME_type};base64,{base64_data}。
本地文件路径：格式：file://{绝对路径}（仅适用于 SDK 调用）。

示例:

[
  "https://img.alicdn.com/imgextra/i2/O1CN01vHOj4h28jOxUJPwY8_!!6000000007968-49-tps-1344-896.webp"
]

取值范围：items: 1–3

string

反向提示词，描述生成图像中需要排除的元素。支持中英文。最多 500 个字符，超出部分将被截断。

示例:low resolution, error, worst quality, low quality, disfigured, extra fingers, bad proportions

object

控制输出分辨率、提示词改写、水印及其他处理选项。

显示子属性

string

默认值"1280*1280"

输出分辨率，格式为 {宽度}*{高度}。默认值：1280*1280。总像素数须在 589,824（768768）到 1,638,400（12801280）之间，宽高比须在 1:4 到 4:1 之间。

推荐分辨率：

1280*1280 (1:1)
1024*1024 (1:1)
800*1200 (2:3)
1200*800 (3:2)
960*1280 (3:4)
1280*960 (4:3)
720*1280 (9:16)
1280*720 (16:9)
1344*576 (21:9)

未指定时，系统默认输出 1280*1280 总像素数的图像，并保留与输入图像相近的宽高比：

单图输入：宽高比与输入图像保持一致。
多图输入：宽高比与最后一张输入图像保持一致。

示例:1280*1280

integer

默认值4

生成图像的数量。有效范围：1 到 4。默认值：4。n 参数直接影响计费，值越大费用越高。建议测试时明确设置为 1 以控制成本。

示例:1

取值范围：1 <= x <= 4

boolean

默认值false

是否在图像右下角添加固定文字 "AI-generated" 水印。

示例:false

boolean

默认值true

开启智能提示词改写。启用后，大语言模型将优化您的提示词以获得更好的效果，但会增加处理时间。默认值：true。

示例:true

integer

随机数种子。取值范围：[0, 2147483647]。未指定时，算法自动生成随机数作为种子。指定后，算法为每张图像（共 n 张）分别生成一个种子值（seed、seed+1、seed+2……）。若需复现特定结果，请使用固定种子值。注意：由于固有随机性，相同种子不一定能生成完全相同的结果。

取值范围：0 <= x <= 2147483647

响应

200-application/json

object

显示子属性

string

任务 ID。可在 24 小时内用于查询任务状态。

enum<string>

任务状态。

可选值：PENDING,RUNNING,SUCCEEDED,FAILED,CANCELED,UNKNOWN

string

请求的唯一标识符，可用于问题追踪与排查。