认证
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|videourl
string处理后的资源 URL
jobId
string远端任务 ID
usage object
使用统计, 仅在状态为 completed 时存在
cost
string总费用(美元)
discount
number折扣金额
metadata object
元数据信息