{
"created": 1761313744,
"id": "task-unified-1774857405-abc123",
"model": "wan3.0-text-to-video",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": true,
"estimated_time": 165,
"video_duration": 8
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 50,
"user_group": "default"
}
}{
"error": {
"code": "invalid_parameter",
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": "insufficient_quota",
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota"
}
}{
"error": {
"code": "model_access_denied",
"message": "Token does not have access to model: wan3.0-text-to-video",
"type": "invalid_request_error"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests, please try again later",
"type": "rate_limit_error"
}
}{
"error": {
"code": "internal_error",
"message": "Internal server error",
"type": "api_error"
}
}Wan3.0 全参数指南
通义万相 3.0(全能参考视频)统一接口,通过 model 参数选择具体模式与版本
3 种生成模式(每种均提供标准版与 Prime):
- Text-to-Video:
wan3.0-text-to-video(标准版)/wan3.0-prime-text-to-video(Prime),纯文本提示词生成视频 - Image-to-Video:
wan3.0-image-to-video(标准版)/wan3.0-prime-image-to-video(Prime),首帧 / 首尾帧严格控制画面起止 - Reference-to-Video:
wan3.0-reference-video(标准版)/wan3.0-prime-reference-video(Prime),参考图 + 参考视频 + 参考音频 + 文件 / 网页多模态混合参考
版本说明:
- 标准版与 Prime 的请求参数、默认值和输入限制完全一致
- 仅
modelID 与分辨率计费倍率不同
共同能力:
- 最长可生成 30 秒视频
- 异步处理模式,使用返回的任务ID 进行查询
- 生成的视频链接,有效期为24小时,请尽快保存
计费说明
- 计费公式:计费时长 = 输入视频时长 + 输出视频时长,按秒计费
- 标准版分辨率倍率:
480p= 1x(基准)、720p= 2x、1080p= 4x - Prime 分辨率倍率:
480p= 1x(基准)、720p= 2.06x、1080p= 4.12x - 参考图片、参考音频、参考文件、网页链接均不计费
duration传-1(智能时长)时按30秒顶格预扣,任务成功后按实际产出时长结算,差额自动退回- 开启或关闭
generate_audio音轨价格相同 - 任务失败不计费,已冻结额度全额退回
{
"created": 1761313744,
"id": "task-unified-1774857405-abc123",
"model": "wan3.0-text-to-video",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": true,
"estimated_time": 165,
"video_duration": 8
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 50,
"user_group": "default"
}
}{
"error": {
"code": "invalid_parameter",
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": "insufficient_quota",
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota"
}
}{
"error": {
"code": "model_access_denied",
"message": "Token does not have access to model: wan3.0-text-to-video",
"type": "invalid_request_error"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests, please try again later",
"type": "rate_limit_error"
}
}{
"error": {
"code": "internal_error",
"message": "Internal server error",
"type": "api_error"
}
}授权
##所有接口均需要使用Bearer Token进行认证##
获取 API Key:
访问 API Key 管理页面 获取您的 API Key
使用时在请求头中添加:
Authorization: Bearer YOUR_API_KEY
请求体
视频生成的文本提示词。支持中英文,每个汉字/字母各占 1 个字符,最大长度 20000 字符,超过部分会自动截断(不报错)
必填性: wan3.0-text-to-video / wan3.0-prime-text-to-video 必传;wan3.0-reference-video / wan3.0-prime-reference-video 与参考素材至少二选一;wan3.0-image-to-video / wan3.0-prime-image-to-video 建议传入以描述画面变化
素材指代规则(参考生视频):
- 用「图1」「视频1」「音频1」指代对应数组中的素材(1-based)
- 图片、视频、音频分别独立计数,即可以同时存在「图1」与「视频1」
"视频1中的角色抱着图3,坐在图4的椅子上弹奏一支舒缓的乡村民谣,并说道:“今天的阳光真好。”"
参考图片 URL 数组,最多 10 张,仅 wan3.0-reference-video / wan3.0-prime-reference-video 可用。可提供主体角色(人物/动物/物体)或场景背景;当包含主体时,建议每张图仅含单一角色
数组顺序对应提示词中的「图1、图2……」
注意: 图生视频的首尾帧请用 image_start / image_end,不要用本字段
图像限制:
- 格式:JPEG、JPG、PNG(不支持透明通道)、BMP、WEBP
- 分辨率:宽和高的范围为
[240, 8000]像素 - 宽高比:1:8 ~ 8:1
- 文件大小:不超过
20MB
10[ "https://example.com/ref1.jpg", "https://example.com/ref2.png" ]
参考视频 URL 数组,最多 5 段,仅 wan3.0-reference-video / wan3.0-prime-reference-video 可用。数组顺序对应提示词中的「视频1、视频2……」
时长限制:
- 单段
1 ~ 15秒 - 合计不超过 15 秒
- 参考视频总时长 + 输出视频时长 不得超过 30 秒
🔴 参考视频计入计费:计费时长 = 输入视频时长 + 输出视频时长。参考图片、参考音频、文件、网页均不计费
视频限制:
- 格式:mp4、mov
- 分辨率:宽和高的范围为
[240, 4096]像素 - 宽高比:1:8 ~ 8:1
- 单文件大小:不超过
100MB
5["https://example.com/ref_video.mp4"]
参考音频 URL 数组,最多 5 段,仅 wan3.0-reference-video / wan3.0-prime-reference-video 可用。数组顺序对应提示词中的「音频1、音频2……」
与 Wan2.7 语义不同: Wan2.7 的 audio_urls 是绑定到某个参考图/参考视频上的音色;Wan3.0 的参考音频是独立素材,由提示词用「音频1」直接指代,不支持 model_params.voice_bindings 音色绑定协议。从 Wan2.7 迁移时请注意改写。
时长限制:
- 单段
1 ~ 15秒,合计不超过 15 秒 - 参考音频不计费
音频限制:
- 格式:wav、mp3
- 文件大小:不超过
15MB
5["https://example.com/ref_audio.mp3"]
任务完成后的 HTTPS 回调地址
回调时机:
- 任务完成(completed)、失败(failed)或取消(cancelled)时触发
- 在计费确认完成后发送
安全限制:
- 仅支持 HTTPS 协议
- 禁止回调到内网 IP 地址(127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x 等)
- URL 长度不超过
2048字符
回调机制:
- 超时时间:
10秒 - 失败后最多重试
3次(分别在失败后1/2/4秒重试) - 回调响应体格式与任务查询接口返回格式一致
- 返回 2xx 状态码视为成功,其他状态码触发重试
"https://your-domain.com/webhooks/video-task-completed"
响应
视频生成任务创建成功