ListenHubDocs
API 参考图片生成

Wan 2.7

Wan 2.7 Image 与 Image Pro 的限制——五种严格校验的宽高比,以及仅 Pro 档支持的 4K。

Wan 2.7 是 ListenHub 上阿里巴巴的图片模型系列:wan2.7-image 和 wan2.7-image-pro。两者都走 共用的图片接口。接口本身、请求 schema、异步流程和错误码请看 图片生成总览,本页只讲 Wan 2.7 的专属 部分。

模型

模型显示名称适用场景
wan2.7-imageWan 2.7 Image在五种常见比例上性价比更高的生成
wan2.7-image-proWan 2.7 Image Pro同样的五种比例,支持 4K 输出

两个模型都使用 provider: "alibaba"。

限制

限制项wan2.7-imagewan2.7-image-pro
图片尺寸1K、2K——4K 返回 4001K、2K、4K(见下文)
宽高比1:1、16:9、9:16、4:3、3:41:1、16:9、9:16、4:3、3:4
默认宽高比请求 schema 给出的 1:1请求 schema 给出的 1:1
参考图最多 9 张最多 9 张
quality忽略忽略

Wan 2.7 是模型目录中对画面形状校验最严格的系列:它会用自己的白名单同时校验尺寸和宽高比, 而上面这五种比例就是全部。2:3、3:2、4:5、5:4、21:9 以及四种极端比例都会返回 400,消息中给出支持的比例列表。需要这五种之外的形状时,请选 Nano Banana Flash 或 Seedream。

4K 仅支持文生图

wan2.7-image-pro 仅在请求不带参考图时才渲染 4K。把 imageSize: "4K" 与非空的 referenceImages 数组组合使用会返回 400,code: 26019,消息是通用的 Unsupported aspect ratio for this model——具体原因只记录在服务端,不会返回。需要参考图引导生成时 降到 2K,或者去掉参考图以使用 4K。

wan2.7-image 无论带多少张参考图都直接拒绝 4K,code: 29003。

两个模型的参考图每次请求上限均为 9 张。超出会返回 400,消息为 Wan2.7 image models support at most 9 reference images。

计费

两个模型都按图片尺寸固定积分计价(pricing.mode 为 fixed),并且都不会设置 requiresSubscription。

两档之间的免费额度不同:wan2.7-image 有一个可用于 1K 和 2K 的免费额度资源,而 wan2.7-image-pro 在任何尺寸下都没有免费额度,始终按积分计费。精确数字请调用 POST /v1/images/generation/estimate-credits 获取。

示例

curl -X POST "https://api.marswave.ai/openapi/v1/images/generation/async" \
  -H "Authorization: Bearer $LISTENHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "alibaba",
    "model": "wan2.7-image-pro",
    "prompt": "A quiet reading room at golden hour, warm wood, soft shadows",
    "imageConfig": { "imageSize": "4K", "aspectRatio": "16:9" }
  }'

完整参数列表和带参考图的请求结构,见 图片生成总览。

本页内容