Wan 2.5 Image-to-Image Preview

wan25_i2i_preview

Wan 2.5 Image-to-Image Preview 是图像编辑模型，可基于文本提示词对输入图像进行变换与编辑，通过中国大陆（北京）节点提供服务。

调用地址

POST /v1/queue/wan25_i2i_preview # 创建任务

GET /v1/queue/wan25_i2i_preview/requests/{request_id}/status # 查询状态

GET /v1/queue/wan25_i2i_preview/requests/{request_id}/response # 获取结果

PUT /v1/queue/wan25_i2i_preview/requests/{request_id}/cancel # 取消任务

请求参数

curl --location "https://cloud.seaart.ai/model/v1/queue/wan25_i2i_preview" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "Turn the reference image into a clean product poster with a white studio background.",
    "images": [
      "https://image.cdn.vtrix.top/2026-04-17/d7h0ad5e8787vbqk6k6g_0/9b65c5d087e41c146d46a5bcf09e2010.webp"
    ],
    "negative_prompt": "low quality, blurry",
    "size": "1024*768",
    "n": 1,
    "prompt_extend": true,
    "watermark": false,
    "seed": 12345
  }'

prompt string 必填

正向提示词，用来描述生成图像中期望包含的元素和视觉特点

支持中英文；最大长度 2000 个字符，超过部分会自动截断

示例：一只坐着的橘黄色的猫, 表情愉悦, 活泼可爱, 逼真准确.

images string[] 必填

图像 URL 数组或 Base64 编码字符串数组，支持单图编辑和多图融合

数组最大长度：3 张图片；多图输入时按数组顺序定义图像顺序

图像格式：JPEG、JPG、PNG、BMP、WEBP；PNG 不支持透明通道

图像宽高：384 - 5000 像素

文件大小：不超过 10MB

negative_prompt string

反向提示词，用来描述不希望在画面中看到的内容，可以对画面进行限制

支持中英文；最大长度 500 个字符，超过部分会自动截断

size string

设置输出图像的分辨率，格式为宽*高。总像素在 768*768 到 1280*1280 之间，且宽高比范围为 1:4 到 4:1。若未指定 size，系统将默认生成总像素为 1280*1280 的图像，并按以下规则保持宽高比：单图输入宽高比与输入图像一致，多图输入宽高比与最后一张输入图像一致

默认值：1280*1280

n int

生成图片的数量。该参数直接影响费用，建议在测试阶段显式设置为 1 以控制成本

范围：1 - 4

默认值：4

prompt_extend bool

是否开启 prompt 智能改写。开启后使用大模型对输入 prompt 进行智能改写，提升综合表现，但会增加耗时

默认值：true

watermark bool

是否添加水印标识。水印位于图像右下角，文案固定为「AI生成」

可选值：false、true

默认值：false

seed int

随机数种子；若不提供，算法自动生成一个随机数作为种子。当 n=4 时，算法会分别生成 seed、seed+1、seed+2、seed+3 作为参数

范围：0 - 2147483647

响应参数

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://cloud.seaart.ai/model/v1/queue/wan25_i2i_preview/requests/mmsu_01hxyz.../response",
  "status_url": "https://cloud.seaart.ai/model/v1/queue/wan25_i2i_preview/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://cloud.seaart.ai/model/v1/queue/wan25_i2i_preview/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

字段	类型	说明
`request_id`	string	任务 ID，后续查询、获取结果和取消都使用它
`response_url`	string	获取最终结果的 URL
`status_url`	string	查询任务状态的 URL
`cancel_url`	string	取消任务的 URL
`queue_position`	int	队列位置

后续操作

查询状态

获取结果

取消任务

错误处理