原站参考文档

以下为胜算云公开资料。文中的原站账号、地址、定价和专有服务不属于蓝天；蓝天可用模型以当前 sub2api 配置为准。接入蓝天请先查看快速开始。

通义万相2.7-图像生成与编辑-Pro（同步任务）

ali/wan2.7-image-pro — 阿里通义万相 Wan2.7 图像生成与编辑 Pro：与标准版同协议，面向更高画质要求的文生图、多图编辑、交互式编辑与组图生成场景。
同步任务：/v1/images/generations、/v1/images/edits，直接返回结果。

BASE URLhttps://router.shengsuanyun.com/api

认证方式Authorization: Bearer YOUR_API_KEY

端点列表

← 上一页

Ali Qwen-Image 系列 · 接口汇总

通义万相2.7-图像生成与编辑-Pro（异步任务）

接口参考

以下为原文协议定义与示例，原站地址不代表蓝天已开通对应能力。蓝天接入地址和模型以本地配置为准。

蓝天 API 密钥

POST/v1/images/generationsAli 图像生成-同步

阿里通义万相 Wan2.7 图像生成与编辑 Pro：与标准版同协议，面向更高画质要求的文生图、多图编辑、交互式编辑与组图生成场景。。同步接口：直接返回生成结果。

请求体

application/json

字段类型说明

input必填

object

展开结构

字段类型说明

messages必填

array

请求内容数组。当前仅支持单轮对话，即传入一组 role、content 参数，不支持多轮对话。

展开结构

请求内容数组。当前仅支持单轮对话，即传入一组 role、content 参数，不支持多轮对话。

array

数组元素

字段	类型	说明
`role`必填	string	消息的角色。固定设置为 user。
`content`必填	array	消息内容数组。可包含文本和 0-9 张图片；多张图片按数组顺序定义图像顺序。展开结构消息内容数组。可包含文本和 0-9 张图片；多张图片按数组顺序定义图像顺序。 `array` 数组元素 `union` oneOf · 1 嵌套结构：object oneOf · 2 嵌套结构：object

parameters

object

展开结构

字段类型说明

bbox_list

array

交互式编辑框选区域。列表长度必须与输入图片数量一致；无需编辑的位置传空列表。单张图片最多支持 2 个边界框。

展开结构

交互式编辑框选区域。列表长度必须与输入图片数量一致；无需编辑的位置传空列表。单张图片最多支持 2 个边界框。

array

数组元素

array

数组元素

边界框坐标 [x1, y1, x2, y2]，使用原图绝对像素坐标。

array

数组元素

integer

enable_sequential boolean 控制生图模式。false 为默认值；true 启用组图输出模式。

size string 输出图片分辨率。可使用 1K、2K、4K，或指定宽高像素值。wan2.7-image-pro 仅文生图且非组图支持 4K；图像编辑和组图生成最高 2K。关于宽高像素值：文生图总像素在 [768*768,4096*4096] 之间，宽高比范围 [1:8,8:1]；其他场景总像素在 [768*768,2048*2048] 之间，宽高比范围 [1:8,8:1]。当有图片输入时，输出宽高比与输入图像（多图输入时为最后一张）一致，并缩放到选定分辨率；当没有图片输入时，输出为正方形。输出图片的像素值可能和指定像素值存在微小差异。

n integer 生成数量。关闭组图模式时取值 1-4，默认 1；开启组图模式时取值 1-12，默认 12，实际数量由模型决定且不超过 n。

thinking_mode boolean 是否开启思考模式。仅在关闭组图模式且无图片输入时生效。

color_palette

array

自定义颜色主题。仅当关闭组图模式（enable_sequential=false）时可用。

展开结构

自定义颜色主题。仅当关闭组图模式（enable_sequential=false）时可用。

array

数组元素

字段	类型	说明
`hex`必填	string	十六进制（HEX）格式的色值。
`ratio`必填	string	颜色所占百分比，需精确到小数点后两位；所有 ratio 值相加总和必须为 100.00%。

watermark boolean 是否添加右下角“AI生成”水印。

seed integer 随机数种子。使用相同 seed 可使生成内容保持相对稳定，但不保证完全一致。

model必填 string 路由模型，本页固定为 ali/wan2.7-image-pro

{
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "text": "一间有着精致窗户的花店，漂亮的木质门，摆放着花朵"
          }
        ]
      }
    ]
  },
  "parameters": {
    "size": "2K",
    "n": 1,
    "watermark": false,
    "thinking_mode": true
  },
  "model": "ali/wan2.7-image-pro"
}

请求示例

参考地址：https://router.shengsuanyun.com/api。路径参数与凭据需替换；非 JSON 请求体需按对应格式准备。

curl -X POST 'https://router.shengsuanyun.com/api/v1/images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "text": "一间有着精致窗户的花店，漂亮的木质门，摆放着花朵"
          }
        ]
      }
    ]
  },
  "parameters": {
    "size": "2K",
    "n": 1,
    "watermark": false,
    "thinking_mode": true
  },
  "model": "ali/wan2.7-image-pro"
}'

响应

200 成功

application/json

未提供结构定义。

{
  "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"
}

400 请求参数错误

application/json

未提供结构定义。

{
  "error": {
    "message": "Invalid request parameters.",
    "type": "invalid_request_error",
    "param": "parameters.size",
    "code": "InvalidParameter"
  }
}

401 鉴权失败（API Key 无效）

application/json

未提供结构定义。

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "param": null,
    "code": "invalid_api_key"
  }
}

429 请求过于频繁

application/json

未提供结构定义。

{
  "error": {
    "message": "Rate limit reached.",
    "type": "rate_limit_error",
    "param": null,
    "code": "rate_limit_exceeded"
  }
}

500 上游服务或内部错误

application/json

未提供结构定义。

{
  "error": {
    "message": "Upstream provider error.",
    "type": "server_error",
    "param": null,
    "code": "upstream_error"
  }
}

POST/v1/images/editsAli 图像编辑-同步

阿里通义万相 Wan2.7 图像生成与编辑 Pro：与标准版同协议，面向更高画质要求的文生图、多图编辑、交互式编辑与组图生成场景。。同步图像编辑接口：直接返回编辑结果。

请求体

application/json

字段类型说明

input必填

object

展开结构

字段类型说明

messages必填

array

请求内容数组。当前仅支持单轮对话，即传入一组 role、content 参数，不支持多轮对话。

展开结构

请求内容数组。当前仅支持单轮对话，即传入一组 role、content 参数，不支持多轮对话。

array

数组元素

字段	类型	说明
`role`必填	string	消息的角色。固定设置为 user。
`content`必填	array	消息内容数组。可包含文本和 0-9 张图片；多张图片按数组顺序定义图像顺序。展开结构消息内容数组。可包含文本和 0-9 张图片；多张图片按数组顺序定义图像顺序。 `array` 数组元素 `union` oneOf · 1 嵌套结构：object oneOf · 2 嵌套结构：object

parameters

object

展开结构

字段类型说明

bbox_list

array

交互式编辑框选区域。列表长度必须与输入图片数量一致；无需编辑的位置传空列表。单张图片最多支持 2 个边界框。

展开结构

交互式编辑框选区域。列表长度必须与输入图片数量一致；无需编辑的位置传空列表。单张图片最多支持 2 个边界框。

array

数组元素

array

数组元素

边界框坐标 [x1, y1, x2, y2]，使用原图绝对像素坐标。

array

数组元素

integer

enable_sequential boolean 控制生图模式。false 为默认值；true 启用组图输出模式。

n integer 生成数量。关闭组图模式时取值 1-4，默认 1；开启组图模式时取值 1-12，默认 12，实际数量由模型决定且不超过 n。

thinking_mode boolean 是否开启思考模式。仅在关闭组图模式且无图片输入时生效。

color_palette

array

自定义颜色主题。仅当关闭组图模式（enable_sequential=false）时可用。

展开结构

自定义颜色主题。仅当关闭组图模式（enable_sequential=false）时可用。

array

数组元素

字段	类型	说明
`hex`必填	string	十六进制（HEX）格式的色值。
`ratio`必填	string	颜色所占百分比，需精确到小数点后两位；所有 ratio 值相加总和必须为 100.00%。

watermark boolean 是否添加右下角“AI生成”水印。

seed integer 随机数种子。使用相同 seed 可使生成内容保持相对稳定，但不保证完全一致。

model必填 string 路由模型，本页固定为 ali/wan2.7-image-pro

{
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "text": "一间有着精致窗户的花店，漂亮的木质门，摆放着花朵"
          }
        ]
      }
    ]
  },
  "parameters": {
    "size": "2K",
    "n": 1,
    "watermark": false,
    "thinking_mode": true
  },
  "model": "ali/wan2.7-image-pro"
}

请求示例

参考地址：https://router.shengsuanyun.com/api。路径参数与凭据需替换；非 JSON 请求体需按对应格式准备。

curl -X POST 'https://router.shengsuanyun.com/api/v1/images/edits' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "text": "一间有着精致窗户的花店，漂亮的木质门，摆放着花朵"
          }
        ]
      }
    ]
  },
  "parameters": {
    "size": "2K",
    "n": 1,
    "watermark": false,
    "thinking_mode": true
  },
  "model": "ali/wan2.7-image-pro"
}'

响应

200 成功

application/json

未提供结构定义。

{
  "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"
}

400 请求参数错误

application/json

未提供结构定义。

{
  "error": {
    "message": "Invalid request parameters.",
    "type": "invalid_request_error",
    "param": "parameters.size",
    "code": "InvalidParameter"
  }
}

401 鉴权失败（API Key 无效）

application/json

未提供结构定义。

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "param": null,
    "code": "invalid_api_key"
  }
}

429 请求过于频繁

application/json

未提供结构定义。

{
  "error": {
    "message": "Rate limit reached.",
    "type": "rate_limit_error",
    "param": null,
    "code": "rate_limit_exceeded"
  }
}

500 上游服务或内部错误

application/json

未提供结构定义。

{
  "error": {
    "message": "Upstream provider error.",
    "type": "server_error",
    "param": null,
    "code": "upstream_error"
  }
}