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

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

查看原文

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

ali/wan2.7-image-pro — 阿里通义万相 Wan2.7 图像生成与编辑 Pro:与标准版同协议,面向更高画质要求的文生图、多图编辑、交互式编辑与组图生成场景。
异步任务:POST /v1/tasks/generations 提交 → GET /v1/tasks/generations/{request_id} 轮询结果(POST 发送后 request_id 自动填入 GET)。

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

端点列表

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

接口参考

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

蓝天 API 密钥
POST/v1/tasks/generationsAli 图像生成-异步

阿里通义万相 Wan2.7 图像生成与编辑 Pro:与标准版同协议,面向更高画质要求的文生图、多图编辑、交互式编辑与组图生成场景。。异步任务:POST 提交后返回 request_id,再用 GET /v1/tasks/generations/{request_id} 轮询结果。

请求体

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、4K,或指定宽高像素值。wan2.7-image-pro 仅文生图且非组图支持 4K;图像编辑和组图生成最高 2K。关于宽高像素值:文生图总像素在 [768*768,4096*4096] 之间,宽高比范围 [1:8,8:1];其他场景总像素在 [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-pro
{
  "model": "ali/wan2.7-image-pro",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "text": "一间有着精致窗户的花店,漂亮的木质门,摆放着花朵"
          }
        ]
      }
    ]
  },
  "parameters": {
    "size": "2K",
    "n": 1,
    "watermark": false,
    "thinking_mode": true
  }
}

请求示例

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

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

响应

200 提交成功,返回 request_id / task_id

application/json

未提供结构定义。

{
  "code": "success",
  "message": "",
  "data": {
    "request_id": "REQ_xxx",
    "task_id": "TASK_xxx",
    "action": "GENERATION",
    "status": "PENDING",
    "progress": "0%"
  }
}
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"
  }
}
GET/v1/tasks/generations/{request_id}查询异步任务状态与产物

通过 POST /v1/tasks/generations 返回的 request_id 轮询任务状态、进度与产物 URL(image_urls / video_urls / audio_urls / file_urls / text)。下方「在线测试」填入 request_id 即可发送查询;若上方 POST 已发送成功,request_id 会自动填入。

请求参数

参数位置 / 类型说明
request_id必填path / stringPOST /v1/tasks/generations 返回的请求 ID

请求示例

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

curl -X GET 'https://router.shengsuanyun.com/api/v1/tasks/generations/{request_id}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

响应

200 任务状态与产物

application/json

未提供结构定义。

{
  "code": "success",
  "message": "",
  "data": {
    "request_id": "202608121234567890",
    "task_id": "upstream-task-id",
    "action": "image",
    "status": "COMPLETED",
    "fail_reason": "",
    "submit_time": 1786500000,
    "start_time": 1786500002,
    "finish_time": 1786500062,
    "progress": "100%",
    "cost": "0.0123",
    "data": {
      "image_urls": [
        "https://dashscope-xxx.oss-xxx.aliyuncs.com/xxx.png?Expires=xxx"
      ]
    }
  }
}
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"
  }
}