1. 模型说明

任务数据（如任务状态、图像URL等）仅保留24小时，超时后会被自动清除。请您务必及时保存生成的图像。

2. 请求协议

https

参数名	类型	描述
anthorization	string	鉴权

3. 功能接口详情

3.1 同步图像生成

3.1.1 请求url

POST https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/wan/image/sync/generation

3.1.2 请求Header

参数名	字段类型	是否必填	默认值	描述
Content-Type	string	是	-	请求内容类型。此参数必须设置为`application/json`。
Authorization	string	是	-	Bearer

3.1.3 请求Body参数

参数名	字段类型	是否必填	默认值	描述
input	object	是	-	输入的基本信息。
input.messages	array	是	-	请求内容数组。当前仅支持单轮对话，即传入一组role、content参数，不支持多轮对话。
input.messages[].role	string	是	-	消息的角色。此参数固定设置为`user`。
input.messages[].content	array	是	-	消息内容数组。
input.messages[].content[].text	string	否	-	用户输入提示词。支持中英文，长度不超过5000个字符，每个汉字、字母、数字或符号计为一个字符，超过部分会自动截断。
input.messages[].content[].image	string	否	-	输入图像的URL或Base64编码字符串。图像限制： - 图像格式：JPEG、JPG、PNG（不支持透明通道）、BMP、WEBP。 - 图像分辨率：图像的宽高范围均为[240, 8000]像素，宽高比范围[1:8, 8:1]。 - 文件大小：不超过20MB。图像数量限制： - 可传入0-9张图片。 - 当输入多张图像时，需在`content`数组中传入多个`image`对象，并按照数组顺序定义图像顺序。支持的输入格式： 1. 使用公网可访问URL - 支持HTTP或HTTPS协议。 - 示例值：`http://wanx.alicdn.com/material/xxx.jpeg`。 2. 传入 Base64 编码图像后的字符串 - 格式：data:{MIME_type};base64,{base64_data} - 示例：data:image/jpeg;base64,GDU7MtCZzEbTbmRZ...（仅示意，实际需传入完整字符串）
parameters	object	否	-	模型参数配置。
parameters.bbox_list	array[array[array[integer]]]	否	-	交互式编辑框选区域。 - 对应关系：列表长度必须与输入图片数量一致。若某张图片无需编辑，请在对应位置传入空列表 `[]`。 - 坐标格式：`[x1, y1, x2, y2]`（左上角 x, 左上角 y, 右下角 x, 右下角 y），使用原图绝对像素坐标，左上角坐标为（0，0）。 - 限制条件：单张图片最多支持 2 个边界框。示例：输入 3 张图片，其中第 2 张无框选，第 1 张有两个框选： `[[[0, 0, 12, 12], [25, 25, 100, 100]], [], [[10, 10, 50, 50]]]`
parameters.enable_sequential	boolean	否	false	控制生图模式： - false：默认值。 - true ：启用组图输出模式。
parameters.size	string	否	2K	关于输出图片分辨率参数，支持以下两种方式，不可混用：模型：wan2.7-image-pro - 方式一：指定输出图片的分辨率（推荐） - 支持 1K、2K（默认）、4K 三种规格 - 适用范围： - 文生图（无图片输入，非组图生成）：支持1K、2K、4K。 - 其他场景：支持1K、2K。 - 各规格总像素：1K：10241024、2K：20482048、4K：40964096 - 图像比例： - 当有图片输入时：输出宽高比与输入图像（多图输入时为最后一张）一致，并缩放到选定分辨率。 - 当没有图片输入时：输出为正方形。 - 方式二：指定生成图像的宽高像素值 - 文生图：总像素在 [768768, 40964096] 之间，宽高比范围为 [1:8, 8:1]。 - 其他场景：总像素在 [768768, 20482048] 之间，宽高比范围为 [1:8, 8:1]。模型：wan2.7-image - 方式一：指定输出图片的分辨率（推荐） - 支持1K、2K（默认）两种规格，不支持4K。 - 方式二：指定生成图像的宽高像素值 - 所有场景下，总像素在 [768768, 2048*2048] 之间，宽高比范围为 [1:8, 8:1]。输出图片的像素值可能和指定像素值存在微小差异。
parameters.n	integer	否	关闭组图为 1；开启组图为 12	重要n直接影响费用。费用 = 单价 × 成功生成的图片张数，请在调用前确认模型价格。 - 关闭组图模式时，该数值代表生成图像数量，取值范围 1-4，默认为 1； - 开启组图模式时，该数值代表最大生成图像数量，取值范围 1-12，默认为 12。实际数量由模型决定且不超过 n。
parameters.thinking_mode	boolean	否	true	是否开启思考模式，默认为`true`（开启）。仅在关闭组图模式且无图片输入时生效。开启时，模型将增强推理能力以提升出图质量，但会增加生成耗时。
parameters.color_palette	array	否	-	自定义颜色主题，一个包含颜色（hex）和占比（ratio）的对象数组，需要包含 3 至 10 种颜色，推荐设置为 8 种。仅当关闭组图模式（`enable_sequential=false`）时可用。
parameters.color_palette[].hex	string	是（使用 color_palette 时）	-	十六进制（HEX）格式的色值。
parameters.color_palette[].ratio	string	是（使用 color_palette 时）	-	颜色所占的百分比，需精确到小数点后两位（如`"25.00%"`）。所有 ratio 值相加总和必须为 100.00%。
parameters.watermark	bool	否	false	是否添加水印标识，水印位于图片右下角，文案固定为“AI生成”。 - false：默认值，不添加水印。 - true：添加水印。
parameters.seed	integer	否	-	随机数种子，取值范围`[0,2147483647]`。使用相同的`seed`参数值可使生成内容保持相对稳定。若不提供，算法将自动使用随机数种子。注意：模型生成过程具有概率性，即使使用相同的`seed`，也不能保证每次生成结果完全一致。

3.1.4 响应参数

参数名	字段类型	描述
output	object	任务输出信息。
output.choices	array	模型生成的输出内容。
output.choices[].finish_reason	string	任务停止原因。自然停止时为`stop`。
output.choices[].message	object	模型返回的消息。
output.choices[].message.role	string	消息的角色，固定为`assistant`。
output.choices[].message.content	array	消息内容数组。
output.choices[].message.content[].type	string	输出的类型，固定为image。
output.choices[].message.content[].image	string	生成图像的 URL，图像格式为PNG。链接有效期为24小时，请及时下载并保存图像。
output.finished	boolean	任务是否结束。 - true：已结束。 - false：未结束。
usage	object	输出信息统计。只对成功的结果计数。
usage.image_count	integer	生成图像的张数。
usage.size	string	生成的图像分辨率。示例值：1376*768。
usage.input_tokens	integer	输入token数量（不计费）。按图片张数计费。
usage.output_tokens	integer	输出token数量（不计费）。按图片张数计费。
usage.total_tokens	integer	总token数量（不计费）。按图片张数计费。
request_id	string	请求唯一标识。可用于请求明细溯源和问题排查。
code	string	请求失败的错误码。请求成功时不会返回此参数。
message	string	请求失败的详细信息。请求成功时不会返回此参数。

3.1.5 请求示例

文生图：

curl --location 'https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/wan/image/sync/generation' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {YOUR_AK}' \
--data '{
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {"text": "一间有着精致窗户的花店，漂亮的木质门，摆放着花朵"}
        ]
      }
    ]
  },
  "parameters": {
    "size": "2K",
    "n": 1,
    "watermark": false,
    "thinking_mode": true
  }
}'

图像编辑：

curl --location 'https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/wan/image/sync/generation' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {YOUR_AK}' \
--data '{
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251229/pjeqdf/car.webp"},
          {"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251229/xsunlm/paint.webp"},
          {"text": "把图2的涂鸦喷绘在图1的汽车上"}
        ]
      }
    ]
  },
  "parameters": {
    "size": "2K",
    "n": 1,
    "watermark": false
  }
}'

交互式编辑：

curl --location 'https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/wan/image/sync/generation' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {YOUR_AK}' \
--data '{
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {"image": "https://img.alicdn.com/imgextra/i3/O1CN0157XGE51l6iL9441yX_!!6000000004770-49-tps-1104-1472.webp"},
          {"image": "https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp"},
          {"text": "把图1的闹钟放在图2的框选的位置，保持场景和光线融合自然"}
        ]
      }
    ]
  },
  "parameters": {
    "bbox_list": [[],[[989, 515, 1138, 681]]],
    "size": "2K",
    "n": 1,
    "watermark": false
  }
}'

组图生成：

curl --location 'https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/wan/image/sync/generation' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {YOUR_AK}' \
--data '{
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {"text": "电影感组图，记录同一只流浪橘猫，特征必须前后一致。第一张：春天，橘猫穿梭在盛开的樱花树下；第二张：夏天，橘猫在老街的树荫下乘凉避暑；第三张：秋天，橘猫踩在满地的金色落叶上；第四张：冬天，橘猫在雪地上走留下足迹。"}
        ]
      }
    ]
  },
  "parameters": {
    "enable_sequential": true,
    "n": 4,
    "size": "2K"
  }
}'

3.1.6 响应示例

任务执行成功：

{
  "output": {
    "choices": [
      {
        "finish_reason": "stop",
        "message": {
          "content": [
            {
              "image": "https://dashscope-xxx.oss-xxx.aliyuncs.com/xxx.png?Expires=xxx",
              "type": "image"
            }
          ],
          "role": "assistant"
        }
      }
    ],
    "finished": true
  },
  "usage": {
    "image_count": 1,
    "input_tokens": 10867,
    "output_tokens": 2,
    "size": "1488*704",
    "total_tokens": 10869
  },
  "request_id": "71dfc3c6-f796-9972-97e4-bc4efc4faxxx"
}

任务执行异常：

{
  "request_id": "a4d78a5f-655f-9639-8437-xxxxxx",
  "code": "InvalidParameter",
  "message": "num_images_per_prompt must be 1"
}

3.2 异步创建图像任务

适用于耗时较长的任务。创建成功后请保存 task_id，通过 §3.3 查询状态与结果。task_id 查询有效期为24小时。

平台会在转调供应商时自动设置 X-DashScope-Async: enable，用户无需传递该 Header。

3.2.1 请求url

POST https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/wan/image/async/generation

3.2.2 请求Header

参数名	字段类型	是否必填	默认值	描述
Content-Type	string	是	-	请求内容类型。此参数必须设置为`application/json`。
Authorization	string	是	-	Bearer

3.2.3 请求Body参数

与 §3.1.3 相同

3.2.4 响应参数

参数名	字段类型	描述
output	object	任务输出信息。
output.task_id	string	任务ID。查询有效期24小时。
output.task_status	string	任务状态。枚举值 - PENDING：任务排队中 - RUNNING：任务处理中 - SUCCEEDED：任务执行成功 - FAILED：任务执行失败 - CANCELED：任务已取消 - UNKNOWN：任务不存在或状态未知
request_id	string	请求唯一标识。可用于请求明细溯源和问题排查。
code	string	请求失败的错误码。请求成功时不会返回此参数。
message	string	请求失败的详细信息。请求成功时不会返回此参数。

3.2.5 请求示例

文生图：

curl --location 'https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/wan/image/async/generation' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {YOUR_AK}' \
--data '{
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {"text": "一间有着精致窗户的花店，漂亮的木质门，摆放着花朵"}
        ]
      }
    ]
  },
  "parameters": {
    "size": "2K",
    "n": 1,
    "watermark": false,
    "thinking_mode": true
  }
}'

图像编辑、交互式编辑、组图生成的 Body 与 §3.1.5 对应示例相同，仅 URL 换为本节异步创建地址。

3.2.6 响应示例

成功响应：

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

异常响应：

{
  "code": "InvalidApiKey",
  "message": "No API-key provided.",
  "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}

3.3 查询图像任务

将 {taskId} 完整替换为异步创建接口返回的 task_id。与现有 Wan 视频任务查询为同一路径。

轮询过程中的状态流转：

PENDING（排队中） → RUNNING（处理中）→ SUCCEEDED（成功）/ FAILED（失败）。
初次查询状态通常为 PENDING（排队中）或 RUNNING（处理中）。
当状态变为 SUCCEEDED 时，响应中将包含生成的图像URL。
若状态为 FAILED，请检查错误信息并重试。

3.3.1 请求url

GET https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/wan/tasks/{taskId}

3.3.2 请求Header / Path 参数

参数名	字段类型	是否必填	默认值	描述
Authorization	string	是	-	Bearer
taskId	string	是	-	任务ID。

3.3.3 响应参数

参数名	字段类型	描述
request_id	string	请求唯一标识。可用于请求明细溯源和问题排查。
output	object	任务输出信息。
output.task_id	string	任务ID。查询有效期24小时。
output.task_status	string	任务状态。枚举值 - PENDING：任务排队中 - RUNNING：任务处理中 - SUCCEEDED：任务执行成功 - FAILED：任务执行失败 - CANCELED：任务已取消 - UNKNOWN：任务不存在或状态未知
output.submit_time	string	任务提交时间。时区为UTC+8，格式为 YYYY-MM-DD HH:mm:ss.SSS。
output.scheduled_time	string	任务执行时间。时区为UTC+8，格式为 YYYY-MM-DD HH:mm:ss.SSS。
output.end_time	string	任务完成时间。时区为UTC+8，格式为 YYYY-MM-DD HH:mm:ss.SSS。
output.finished	boolean	任务是否结束。 - true：已结束。 - false：未结束。
output.choices	array	模型生成的输出内容。
output.choices[].finish_reason	string	任务停止原因，自然停止时为`stop`。
output.choices[].message	object	模型返回的消息。
output.choices[].message.role	string	消息的角色，固定为`assistant`。
output.choices[].message.content	array	消息内容数组。
output.choices[].message.content[].type	string	输出的类型，枚举值为text、image。
output.choices[].message.content[].text	string	生成的文字。
output.choices[].message.content[].image	string	生成图像的 URL，图像格式为PNG。链接有效期为24小时，请及时下载并保存图像。
usage	object	输出信息统计。只对成功的结果计数。
usage.image_count	integer	生成图像的张数。
usage.size	string	生成的图像分辨率。示例值：1376*768。
usage.input_tokens	integer	输入token数量（不计费）。按图片张数计费。
usage.output_tokens	integer	输出token数量（不计费）。按图片张数计费。
usage.total_tokens	integer	总token数量（不计费）。按图片张数计费。
code	string	请求失败的错误码。请求成功时不会返回此参数。
message	string	请求失败的详细信息。请求成功时不会返回此参数。

3.3.4 请求示例

curl -X GET 'https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/wan/tasks/{taskId}' \
--header 'Authorization: Bearer {YOUR_AK}'

3.3.5 响应示例

任务执行成功：

{
  "request_id": "810fa5f5-334c-91f3-aaa4-ed89cf0caxxx",
  "output": {
    "task_id": "a81ee7cb-014c-473d-b842-76e98311cxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-03-26 17:16:01.663",
    "scheduled_time": "2026-03-26 17:16:01.716",
    "end_time": "2026-03-26 17:16:22.961",
    "finished": true,
    "choices": [
      {
        "finish_reason": "stop",
        "message": {
          "role": "assistant",
          "content": [
            {
              "image": "https://dashscope-xxx.oss-xxx.aliyuncs.com/xxx.png?Expires=xxx",
              "type": "image"
            }
          ]
        }
      }
    ]
  },
  "usage": {
    "size": "2976*1408",
    "total_tokens": 11017,
    "image_count": 1,
    "output_tokens": 2,
    "input_tokens": 11015
  }
}

任务执行异常：

{
  "request_id": "a4d78a5f-655f-9639-8437-xxxxxx",
  "code": "InvalidParameter",
  "message": "num_images_per_prompt must be 1"
}