⌘K

Wan 2.5 Text-to-Image Preview

wan25_t2i_preview

Wan2.5 Text-to-Image Preview 是阿里巴巴的图像生成模型, 在总像素约束下支持灵活分辨率, 通过中国大陆(北京)节点提供服务.

认证

authorization string 必填

所有 API 均使用 Bearer Token 鉴权

获取 API Key:

访问 API Key 管理页面 获取 API Key

用法:

将以下 Header 添加到请求中:

Authorization: Bearer YOUR_API_KEY

参数

model string 必填

请求使用的模型 ID

值: wan25_t2i_preview


input object 必填

生成请求的输入数据

prompt string 必填

正向提示词, 用于描述期望生成的图像内容、风格和构图. 支持中英文.

negative_prompt string

反向提示词, 描述不希望出现在生成图像中的内容.


parameters object

图像处理参数

size string

输出图像的分辨率, 格式为 宽*高. 总像素在 [1280×1280, 1440×1440] 之间, 且宽高比范围为 [1:4, 4:1]. 例如 768×2700 符合要求.

常见宽高比推荐分辨率:
1:1:1280×1280
3:4:1104×1472
4:3:1472×1104
9:16:960×1696
16:9:1696×960

默认值: 1280×1280

n integer

生成图片的数量. 该参数直接影响费用(费用 = 单价 × 图片张数), 请在调用前确认模型价格. 建议在测试阶段设置为 1.

范围: 1 - 4

默认值: 4

prompt_extend boolean

是否开启 prompt 智能改写. 开启后将使用大模型优化正向提示词, 对较短的提示词有明显提升效果, 但会增加 3–4 秒耗时.

可选值: true, false

默认值: true

watermark boolean

是否添加水印标识. 水印位于图像右下角, 文案固定为「AI生成」.

可选值: false, true

默认值: false

seed integer

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

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

范围: 0 - 2147483647


轮询

由于结果生成需要时间,您需要在创建任务后轮询任务状态

初始响应只返回任务 ID 和初始状态等信息,最终生成结果需通过使用该任务 ID 轮询任务状态接口获取

轮询请求与响应示例见右侧


响应格式

error object

错误信息, 仅在状态为 failed 时存在

code string

错误码

message string

详细错误信息


output array

生成结果, 仅在状态为 completed 时存在

content array

生成的资源内容列表

type string

资源类型

值: image|video

url string

处理后的资源 URL

jobId string

远端任务 ID


usage object

使用统计, 仅在状态为 completed 时存在

cost string

总费用(美元)

discount number

折扣金额


metadata object

元数据信息