Skip to main content
POST

授权

Authorization
string
header
必填

在请求头中传入 Authorization: Bearer <token>

请求体

application/json
model
enum<string>
必填

模型名称。可选值:wan2.7-image-pro

可用选项:
wan2.7-image-pro
input
object
必填
response_format
enum<string>
默认值:url

统一响应格式。支持的值:urlb64_json

可用选项:
url,
b64_json
size
string
默认值:1K

关于输出图片分辨率参数,支持以下两种方式,不可混用:

方式一:指定输出图片的分辨率(推荐) 支持 1K、2K(默认)、4K 三种规格。

  • 文生图(无图片输入,非组图生成):支持 1K、2K、4K。
  • 其他场景:支持 1K、2K。
  • 各规格总像素:1K:1024×1024、2K:2048×2048、4K:4096×4096。
  • 当有图片输入时:输出宽高比与输入图像(多图输入时为最后一张)一致,并缩放到选定分辨率。
  • 当没有图片输入时:输出为正方形。

方式二:指定生成图像的宽高像素值 格式:{width}*{height},例如 1024*768

  • 文生图:总像素在 [768×768, 4096×4096] 之间,宽高比范围 [1:8, 8:1]。
  • 其他场景:总像素在 [768×768, 2048×2048] 之间,宽高比范围 [1:8, 8:1]。

注意:输出图片的像素值可能和指定像素值存在微小差异。

n
integer

重要:n 直接影响费用。费用 = 单价 × 成功生成的图片张数,请在调用前确认模型价格。

必填范围:1 <= n <= 12。

关闭组图模式时,该数值代表生成图像数量,取值范围 1-4,默认为 1; 开启组图模式时,该数值代表最大生成图像数量,取值范围 1-12,默认为 12。实际数量由模型决定且不超过 n

必填范围: 1 <= x <= 12
watermark
boolean
默认值:false

是否添加水印标识,水印位于图片右下角,文案固定为 "AI生成"。false(默认值):不添加水印。true:添加水印。

thinking_mode
boolean

是否开启思考模式,默认为 true(开启)。开启时,模型将增强推理能力以提升出图质量,但会增加生成耗时。仅在关闭组图模式时生效。

enable_sequential
boolean

控制生成模式。false(默认):普通模式。true:开启组图输出模式。

color_palette
object[]

自定义颜色主题,一个包含颜色(hex)和占比(ratio)的对象数组。需要包含 3 至 10 种颜色,推荐设置为 8 种。仅当关闭组图模式(enable_sequential=false)时可用。

seed
integer<int64>
默认值:0

随机数种子,取值范围 [0, 2147483647]。

使用相同的 seed 参数值可使生成内容保持相对稳定。若不提供,算法将自动使用随机数种子。

注意:模型生成过程具有概率性,即使使用相同的 seed,也不能保证每次生成结果完全一致。

必填范围: x >= 0

响应

调用成功,返回图像生成结果。

created
integer<int64>

响应生成时间戳。

data
object[]

生成后的图片结果列表。

metadata
object

透传的上游原始响应元数据。