统一模型接入与用量管理 立即注册
蓝天
原站参考文档

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

查看原文

通义万相2.7-图像生成与编辑(同步任务)

ali/wan2.7-image — 阿里通义万相 Wan2.7 图像生成与编辑模型:支持文生图、图生图、多图编辑、交互式编辑(bbox 框选)与组图生成(一次出 4 张连贯画面),并支持思考模式与自定义色板。
同步任务:/v1/images/generations、/v1/images/edits,直接返回结果。

BASE URLhttps://router.shengsuanyun.com/api
认证方式Authorization: Bearer YOUR_API_KEY

端点列表

← 上一页
通义万相2.7-图像生成与编辑-Pro(异步任务)
下一页 →
通义万相2.7-图像生成与编辑(异步任务)

接口参考

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

蓝天 API 密钥
POST/v1/images/generationsAli 图像生成-同步

阿里通义万相 Wan2.7 图像生成与编辑模型:支持文生图、图生图、多图编辑、交互式编辑(bbox 框选)与组图生成(一次出 4 张连贯画面),并支持思考模式与自定义色板。。同步接口:直接返回生成结果。

请求体

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

parametersobject
展开结构
字段类型说明
bbox_listarray交互式编辑框选区域。列表长度必须与输入图片数量一致;无需编辑的位置传空列表。单张图片最多支持 2 个边界框。
展开结构

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

array

数组元素

array

数组元素

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

array

数组元素

integer

enable_sequentialboolean控制生图模式。false 为默认值;true 启用组图输出模式。
sizestring输出图片分辨率。可使用 1K、2K,或指定宽高像素值。wan2.7-image 不支持 4K。关于宽高像素值:所有场景下总像素在 [768*768,2048*2048] 之间,宽高比范围 [1:8,8:1]。当有图片输入时,输出宽高比与输入图像(多图输入时为最后一张)一致,并缩放到选定分辨率;当没有图片输入时,输出为正方形。输出图片的像素值可能和指定像素值存在微小差异。
ninteger生成数量。关闭组图模式时取值 1-4,默认 1;开启组图模式时取值 1-12,默认 12,实际数量由模型决定且不超过 n。
thinking_modeboolean是否开启思考模式。仅在关闭组图模式且无图片输入时生效。
color_palettearray自定义颜色主题。仅当关闭组图模式(enable_sequential=false)时可用。
展开结构

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

array

数组元素
字段类型说明
hex必填string十六进制(HEX)格式的色值。
ratio必填string颜色所占百分比,需精确到小数点后两位;所有 ratio 值相加总和必须为 100.00%。
watermarkboolean是否添加右下角“AI生成”水印。
seedinteger随机数种子。使用相同 seed 可使生成内容保持相对稳定,但不保证完全一致。
model必填string路由模型,本页固定为 ali/wan2.7-image
{
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "text": "一间有着精致窗户的花店,漂亮的木质门,摆放着花朵"
          }
        ]
      }
    ]
  },
  "parameters": {
    "size": "2K",
    "n": 1,
    "watermark": false,
    "thinking_mode": true
  },
  "model": "ali/wan2.7-image"
}

请求示例

参考地址: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"
}'

响应

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 图像生成与编辑模型:支持文生图、图生图、多图编辑、交互式编辑(bbox 框选)与组图生成(一次出 4 张连贯画面),并支持思考模式与自定义色板。。同步图像编辑接口:直接返回编辑结果。

请求体

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

parametersobject
展开结构
字段类型说明
bbox_listarray交互式编辑框选区域。列表长度必须与输入图片数量一致;无需编辑的位置传空列表。单张图片最多支持 2 个边界框。
展开结构

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

array

数组元素

array

数组元素

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

array

数组元素

integer

enable_sequentialboolean控制生图模式。false 为默认值;true 启用组图输出模式。
sizestring输出图片分辨率。可使用 1K、2K,或指定宽高像素值。wan2.7-image 不支持 4K。关于宽高像素值:所有场景下总像素在 [768*768,2048*2048] 之间,宽高比范围 [1:8,8:1]。当有图片输入时,输出宽高比与输入图像(多图输入时为最后一张)一致,并缩放到选定分辨率;当没有图片输入时,输出为正方形。输出图片的像素值可能和指定像素值存在微小差异。
ninteger生成数量。关闭组图模式时取值 1-4,默认 1;开启组图模式时取值 1-12,默认 12,实际数量由模型决定且不超过 n。
thinking_modeboolean是否开启思考模式。仅在关闭组图模式且无图片输入时生效。
color_palettearray自定义颜色主题。仅当关闭组图模式(enable_sequential=false)时可用。
展开结构

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

array

数组元素
字段类型说明
hex必填string十六进制(HEX)格式的色值。
ratio必填string颜色所占百分比,需精确到小数点后两位;所有 ratio 值相加总和必须为 100.00%。
watermarkboolean是否添加右下角“AI生成”水印。
seedinteger随机数种子。使用相同 seed 可使生成内容保持相对稳定,但不保证完全一致。
model必填string路由模型,本页固定为 ali/wan2.7-image
{
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "text": "一间有着精致窗户的花店,漂亮的木质门,摆放着花朵"
          }
        ]
      }
    ]
  },
  "parameters": {
    "size": "2K",
    "n": 1,
    "watermark": false,
    "thinking_mode": true
  },
  "model": "ali/wan2.7-image"
}

请求示例

参考地址: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"
}'

响应

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