阿里云百炼视频生成 API 文档

概述

阿里云百炼提供通义万相系列和 Vidu 系列视频生成模型，支持文生视频、图生视频、视频生视频三种模式。

模型名称	类型	说明
`Wan2.6-T2V`	文生视频	通义万相文生视频模型，根据文本提示词生成视频
`Wan2.6-I2V`	图生视频	通义万相图生视频模型，根据图片和文本提示词生成视频
`Wan2.6-R2V`	视频生视频	通义万相视频生视频模型，根据参考视频和文本提示词生成视频

支持两种输入格式：标准格式和服务商原生格式。服务商原生格式优先于标准格式，如果同时传入则使用原生格式。

Wan2.6-T2V 文生视频

根据文本提示词生成视频，支持音频驱动。

官方文档：阿里云百炼文生视频 API

请求参数

参数名	类型	必填	说明	取值范围/格式
`model`	string	是	模型名称	`Wan2.6-T2V`
`prompt`	string	是	文本提示词，描述要生成的视频内容	非空字符串
`seconds`	integer	否	视频时长（秒）	正整数
`size`	string	否	视频尺寸	见支持的视频尺寸
`prompt_extend`	boolean	否	是否启用提示词扩展	`true`、`false`，默认 `true`
`shot_type`	string	否	镜头类型	`single`、`multi`，默认 `multi`
`audio_url`	string	否	音频 URL，用于音频驱动视频生成	有效的音频 URL
`callback_url`	string	否	任务结果回调地址	有效的 URL 地址

请求示例

基础文生视频：

json

{
  "model": "Wan2.6-T2V",
  "prompt": "一只可爱的猫咪在草地上玩耍，阳光明媚",
  "size": "1280*720",
  "seconds": 5,
  "prompt_extend": true,
  "shot_type": "multi"
}

音频驱动视频：

json

{
  "model": "Wan2.6-T2V",
  "prompt": "一个人随着音乐节奏跳舞",
  "audio_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/ozwpvi/rap.mp3",
  "size": "1080*1920",
  "seconds": 5
}

响应示例

任务提交响应：

json

{
  "id": "task_abc123",
  "status": "queued",
  "model": "Wan2.6-T2V",
  "seconds": 5,
  "size": "1280*720",
  "provider": "阿里云百炼"
}

字段说明：id、status、model 始终返回；seconds、size、provider 仅在值非空时出现。status 默认值为 "queued"。

任务完成响应（GET /videos/{task_id}）：

json

{
  "id": "task_abc123",
  "status": "completed",
  "seconds": 5,
  "size": "1280*720",
  "completed_at": "2025-01-13T10:03:00.000000+08:00",
  "updated_at": "2025-01-13T10:03:00.000000+08:00",
  "video_url": "https://example.com/generated-video.mp4",
  "usage": {
    "seconds": 10.0,
    "video_count": 1,
    "size": "1280*720"
  },
  "raw_response": { ... }
}

注意事项

只需 prompt 参数即可生成视频。
通过 audio_url 参数可实现音频驱动视频生成。
计费按 usage.seconds 计算。

Wan2.6-I2V 图生视频

根据输入图片和文本提示词生成视频，支持音频驱动。

官方文档：阿里云百炼图生视频 API

请求参数

参数名	类型	必填	说明	取值范围/格式
`model`	string	是	模型名称	`Wan2.6-I2V`
`prompt`	string	是	文本提示词，描述要生成的视频内容	非空字符串
`img_url`	string	是	输入图片 URL	有效的图片 URL
`seconds`	integer	否	视频时长（秒）	正整数
`size`	string	否	视频尺寸	见支持的视频尺寸
`prompt_extend`	boolean	否	是否启用提示词扩展	`true`、`false`，默认 `true`
`shot_type`	string	否	镜头类型	`single`、`multi`，默认 `multi`
`audio_url`	string	否	音频 URL，用于音频驱动视频生成	有效的音频 URL
`callback_url`	string	否	任务结果回调地址	有效的 URL 地址

请求示例

json

{
  "model": "Wan2.6-I2V",
  "prompt": "一幅都市奇幻艺术的场景。一个充满动感的涂鸦艺术角色。一个由喷漆所画成的少年，正从一面混凝土墙上活过来。他一边用极快的语速演唱一首英文rap，一边摆着一个经典的、充满活力的说唱歌手姿势。场景设定在夜晚一个充满都市感的铁路桥下。灯光来自一盏孤零零的街灯，营造出电影般的氛围，充满高能量和惊人的细节。视频的音频部分完全由他的rap构成，没有其他对话或杂音。",
  "img_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png",
  "audio_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/ozwpvi/rap.mp3",
  "size": "720P",
  "seconds": 5
}

响应示例

任务提交响应：

json

{
  "id": "task_abc123",
  "status": "queued",
  "model": "Wan2.6-I2V",
  "seconds": 5,
  "size": "720*1280",
  "provider": "阿里云百炼"
}

字段说明：id、status、model 始终返回；seconds、size、provider 仅在值非空时出现。status 默认值为 "queued"。

任务完成响应（GET /videos/{task_id}）：

json

{
  "id": "task_abc123",
  "status": "completed",
  "seconds": 5,
  "size": "720*1280",
  "completed_at": "2025-01-13T10:03:00.000000+08:00",
  "updated_at": "2025-01-13T10:03:00.000000+08:00",
  "video_url": "https://example.com/generated-video.mp4",
  "usage": {
    "seconds": 5.0,
    "video_count": 1,
    "size": "720*1280"
  },
  "raw_response": { ... }
}

注意事项

必须同时提供 prompt 和 img_url 参数。
可通过 audio_url 参数实现音频驱动视频生成。
计费按 usage.seconds 计算。

Wan2.6-R2V 视频生视频

根据参考视频和文本提示词生成新视频。

官方文档：阿里云百炼视频生视频 API

请求参数

参数名	类型	必填	说明	取值范围/格式
`model`	string	是	模型名称	`Wan2.6-R2V`
`prompt`	string	是	文本提示词，描述要生成的视频内容	非空字符串
`reference_video_urls`	array	是	参考视频 URL 列表	有效的视频 URL 数组
`seconds`	integer	否	视频时长（秒）	正整数
`size`	string	否	视频尺寸	见支持的视频尺寸
`prompt_extend`	boolean	否	是否启用提示词扩展	`true`、`false`，默认 `true`
`shot_type`	string	否	镜头类型	`single`、`multi`，默认 `multi`
`audio_url`	string	否	音频 URL，用于音频驱动视频生成	有效的音频 URL
`callback_url`	string	否	任务结果回调地址	有效的 URL 地址

请求示例

json

{
  "model": "Wan2.6-R2V",
  "prompt": "character1一边喝奶茶，一边随着音乐即兴跳舞。",
  "reference_video_urls": [
    "https://cdn.wanx.aliyuncs.com/static/demo-wan26/vace.mp4"
  ],
  "size": "1280*720",
  "seconds": 5
}

响应示例

任务提交响应：

json

{
  "id": "task_abc123",
  "status": "queued",
  "model": "Wan2.6-R2V",
  "seconds": 5,
  "size": "1280*720",
  "provider": "阿里云百炼"
}

字段说明：id、status、model 始终返回；seconds、size、provider 仅在值非空时出现。status 默认值为 "queued"。

任务完成响应（GET /videos/{task_id}）：

json

{
  "id": "task_abc123",
  "status": "completed",
  "seconds": 5,
  "size": "1280*720",
  "completed_at": "2025-01-13T10:03:00.000000+08:00",
  "updated_at": "2025-01-13T10:03:00.000000+08:00",
  "video_url": "https://example.com/generated-video.mp4",
  "usage": {
    "seconds": 10.0,
    "video_count": 1,
    "size": "1280*720"
  },
  "raw_response": { ... }
}

注意事项

必须同时提供 prompt 和 reference_video_urls 参数。
计费按 usage.seconds 计算。输入参考视频的时长也会计入。

Vidu 文生视频

基于文本提示词生成视频，支持有声视频生成。Vidu 系列包含以下模型变体：

模型名称	时长范围	有声视频	说明
`ViduQ3-Pro-Text2Video`	1~16 秒，默认 5	支持	Q3 Pro，高质量生成
`ViduQ3-Turbo-Text2Video`	1~16 秒，默认 5	支持	Q3 Turbo，快速生成
`ViduQ2-Text2Video`	1~10 秒，默认 5	不支持	Q2 版本

官方文档：阿里云百炼 Vidu 文生视频 API

请求参数

参数名	类型	必填	说明	取值范围/格式
`model`	string	是	模型名称	见上方模型变体表
`prompt`	string	是	文本提示词，描述要生成的视频内容	非空字符串，最多 5000 字符
`duration`	integer	否	视频时长（秒）	Q3 系列：`[1, 16]`，Q2：`[1, 10]`，默认 `5`
`resolution`	string	否	分辨率档位	`540P`、`720P`（默认）、`1080P`
`size`	string	否	视频尺寸（宽*高）	见Vidu 支持的视频尺寸
`audio`	boolean	否	是否生成有声视频	`true`、`false`，默认 `false`（仅 Q3 系列支持）
`watermark`	boolean	否	是否添加水印（右下角"内容由AI生成"）	`true`、`false`，默认 `false`
`seed`	integer	否	随机数种子，用于提升结果可复现性	`[0, 2147483647]`

注意：resolution 直接影响费用，请在调用前确认模型价格。duration 按秒计费，时间越长费用越高。

请求示例

基础文生视频：

bash

curl -X POST 'https://aiping.cn/api/v1/videos' \
-H "Authorization: Bearer $API_KEY" \
-H 'Content-Type: application/json' \
-d '{
  "model": "ViduQ3-Turbo-Text2Video",
  "prompt": "一只小猫在月光下奔跑",
  "resolution": "540P",
  "duration": 5,
  "watermark": true
}'

生成有声视频（仅 Q3 系列）：

bash

curl -X POST 'https://aiping.cn/api/v1/videos' \
-H "Authorization: Bearer $API_KEY" \
-H 'Content-Type: application/json' \
-d '{
  "model": "ViduQ3-Pro-Text2Video",
  "prompt": "海浪拍打礁石，海鸥在天空盘旋",
  "size": "1280*720",
  "resolution": "720P",
  "duration": 8,
  "audio": true
}'

响应示例

任务提交响应：

json

{
  "id": "task_abc123",
  "status": "queued",
  "model": "ViduQ3-Turbo-Text2Video",
  "seconds": 5,
  "size": "960*528",
  "provider": "阿里云百炼"
}

字段说明：id、status、model 始终返回；seconds、size、provider 仅在值非空时出现。

任务完成响应（GET /videos/{task_id}）：

json

{
  "id": "task_abc123",
  "status": "completed",
  "seconds": 5,
  "size": "960*528",
  "completed_at": "2025-01-13T10:03:00.000000+08:00",
  "updated_at": "2025-01-13T10:03:00.000000+08:00",
  "video_url": "https://example.com/generated-video.mp4",
  "usage": {
    "seconds": 5.0,
    "video_count": 1,
    "size": "960*528"
  },
  "raw_response": { ... }
}

注意事项

resolution 和 size 推荐同时传入，以精准控制宽高比。仅传 size 时会被忽略，强制按默认 720P 处理；仅传 resolution 时按对应档位的 16:9 比例输出。
audio 参数仅 Q3 系列（viduq3-pro、viduq3-turbo）支持，Q2 模型不支持有声视频。
duration 直接影响费用，按秒计费。
视频 URL 有效期为 24 小时，请及时下载保存。

Vidu 图生视频-基于首帧

Vidu-图生视频模型根据输入图像和文本提示词，生成一段流畅的视频。

模型名称	时长范围	有声视频	说明
`ViduQ3-Pro-Img2Video`	1~16 秒，默认 5	支持	Q3 Pro，高质量生成
`ViduQ3-Turbo-Img2Video`	1~16 秒，默认 5	支持	Q3 Turbo，快速生成
`ViduQ2-Pro-Img2Video`	1~10 秒，默认 5	不支持	Q2 Pro，高质量生成
`ViduQ2-Turbo-Img2Video`	1~16 秒，默认 5	支持	Q2 Turbo，快速生成

步骤1

创建任务获取任务ID POST https://aiping.cn/api/v1/videos

步骤2

创建成功后，使用接口返回的 task_id 查询结果，task_id 有效期为 24 小时。请勿重复创建任务，轮询获取即可。

请求参数

参数名	类型	必填	说明	取值范围/格式
`model`	string	是	模型名称
`prompt`	string	否	文本提示词，描述要生成的视频内容	非空字符串，最多 5000 字符
`img_url`	string	是	输入图像 URL	公网可访问 URL；JPG/PNG/WEBP；宽高比 1:4～4:1；大小 ≤ 50MB
`resolution`	string	否	分辨率档位（直接影响费用）	Q3：`540P`/`720P`/`1080P`，默认 `720P`；Q2：`720P`/`1080P`，默认 `720P`
`duration`	integer	否	视频时长（秒），按秒计费	Q3：`[1,16]`，默认 `5`；Q2：`[1,10]`，默认 `5`
`audio`	boolean	否	是否生成有声视频（仅 Q3 系列支持）	`true`、`false`，默认 `false`
`watermark`	boolean	否	是否添加右下角"内容由AI生成"水印	`true`、`false`，默认 `false`
`seed`	integer	否	随机数种子	`[0, 2147483647]`

请求头：需携带 Content-Type: application/json 和 Authorization: Bearer $API_KEY。

请求示例

bash

curl -X POST 'https://aiping.cn/api/v1/videos' \
-H "Authorization: Bearer $API_KEY" \
-H 'Content-Type: application/json' \
-d '{
  "model": "ViduQ3-Pro-Img2Video",
  "prompt": "镜头从海龟下方缓缓上移，海龟悠然游动，腹部细节清晰可见。",
  "img_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260121/zlpocv/wan-i2v-haigui.webp",
  "duration": 5,
  "resolution": "720P",
  "watermark": true
}'

响应参数

参数名	类型	说明
`id`	string	任务 ID，用于查询任务状态与结果
`status`	string	任务状态，默认值为 `queued`
`model`	string	模型名称
`seconds`	integer	视频时长（秒），仅在值非空时出现
`size`	string	视频尺寸，仅在值非空时出现
`provider`	string	服务商名称，仅在值非空时出现

创建任务后，请通过 Vidu 任务查询接口轮询获取结果。

Vidu 首尾帧生视频

Vidu-首尾帧生视频模型基于首帧图像、尾帧图像和文本提示词，生成一段平滑过渡的视频。

模型名称	时长范围	有声视频	说明
`ViduQ3-Pro-Start-End2Video`	1~16 秒，默认 5	支持	Q3 Pro，高质量生成
`ViduQ2-Pro-Start-End2Video`	1~16 秒，默认 5	支持	Q2 Pro，高质量生成
`ViduQ2-Turbo-Start-End2Video`	1~10 秒，默认 5	不支持	Q2 快速生成

步骤1

创建任务获取任务ID POST https://aiping.cn/api/v1/videos

步骤2

创建成功后，使用接口返回的 task_id 查询结果，task_id 有效期为 24 小时。请勿重复创建任务，轮询获取即可。

请求参数

参数名	类型	必填	说明	取值范围/格式
`model`	string	是	模型名称	首尾帧生视频模型
`prompt`	string	是	描述首帧到尾帧之间变化过程	非空字符串，最多 5000 字符
`first_frame_url`	string	是	首帧图像 URL	公网可访问 URL；JPG/PNG/WEBP；宽高比 1:4～4:1；大小 ≤ 50MB；首尾帧分辨率总像素比值需在 0.8～1.25
`last_frame_url`	string	是	尾帧图像 URL	公网可访问 URL；JPG/PNG/WEBP；宽高比 1:4～4:1；大小 ≤ 50MB；首尾帧分辨率总像素比值需在 0.8～1.25
`resolution`	string	是	分辨率档位（直接影响费用）	`540P`、`720P`（默认）、`1080P`
`duration`	integer	是	视频时长（秒），按秒计费	Q3：`[1,16]`，Q2：`[1,10]`，默认 `5`
`audio`	boolean	否	是否生成有声视频（仅 Q3 系列支持）	`true`、`false`，默认 `false`
`watermark`	boolean	否	是否添加右下角"内容由AI生成"水印	`true`、`false`，默认 `false`
`seed`	integer	否	随机数种子	`[0, 2147483647]`

请求头：需携带 Content-Type: application/json 和 Authorization: Bearer $API_KEY。

请求示例

bash

curl -X POST 'https://aiping.cn/api/v1/videos' \
-H "Authorization: Bearer $API_KEY" \
-H 'Content-Type: application/json' \
-d '{
    "model": "ViduQ3-Pro-Start-End2Video",
    "prompt": "花瓣掉落下来",
    "reference_images": [
        "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png",
        "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png",
    ],
    "duration": 5,
    "resolution": "540p"
}'

成功响应

json

{
  "id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
  "status": "queued",
  "model": "ViduQ3-Turbo-Start-End2Video",
  "seconds": 5,
  "size": "960*528",
  "provider": "阿里云百炼"
}

字段说明：id、status、model 始终返回；seconds、size、provider 仅在值非空时出现。status 默认值为 "queued"。

异常响应

创建任务失败，请参见错误信息进行解决。

响应参数

参数名	类型	说明
`id`	string	任务 ID，用于查询任务状态与结果
`status`	string	任务状态，默认值为 `queued`
`model`	string	模型名称
`seconds`	integer	视频时长（秒），仅在值非空时出现
`size`	string	视频尺寸，仅在值非空时出现
`provider`	string	服务商名称，仅在值非空时出现

创建任务后，请通过 Vidu 任务查询接口轮询获取结果。

错误码

如果模型调用失败并返回报错信息，请参见错误信息进行解决。

常见问题

Q：media数组中首帧和尾帧的顺序是否有要求？

A：有顺序要求。第一个元素表示首帧，第二个元素表示尾帧。

Q：首帧和尾帧图像的分辨率是否需要一致？

A：建议保持相近。首帧和尾帧总像素数（宽×高）比值需控制在 0.8～1.25 之间。若分辨率差异过大，会导致生成质量下降。

Vidu 参考生视频

Vidu-参考生视频模型支持传入参考图片和文本提示词，将图片中的主体角色融合到提示词描述的场景中，生成流畅的视频内容。

模型名称	时长范围	参考视频	说明
`ViduQ2-Pro-Reference2Video`	1~10 秒，默认 5	支持	Q2 Pro，支持参考图像+参考视频

步骤 1

创建任务获取任务 ID POST https://aiping.cn/api/v1/videos

步骤 2

创建成功后，使用接口返回的 task_id 查询结果，task_id 有效期为 24 小时。请勿重复创建任务，轮询获取即可。

请求参数

参数名	类型	必填	说明	取值范围/格式
`model`	string	是	模型名称
`prompt`	string	是	描述生成视频中期望包含的元素和视觉特点	非空字符串，最多 5000 字符
`reference_images`	array	是	参考图像 URL 列表	`viduq2`：图像 1～7 张；`viduq2-pro` 仅图像时 1～7，搭配视频时 1～4。JPEG/JPG/PNG/WEBP；宽高比 1:4～4:1；大小 ≤ 50MB
`reference_video_urls`	array	否	参考视频 URL 列表（仅 `viduq2-pro` 支持）	视频 1～2 个。mp4/avi/mov；总像素 ≥ 128×128；宽高比 1:4～4:1；时长 1～5 秒；大小 ≤ 50MB
`resolution`	string	否	分辨率档位（直接影响费用）	`540P`、`720P`（默认）、`1080P`
`size`	string	否	视频尺寸（宽*高），默认由 `resolution` 决定	见 Vidu 支持的视频尺寸
`duration`	integer	是	视频时长（秒），按秒计费	`[1,10]`，默认 `5`；`viduq2-pro` 还支持 `0`（自动规划时长，上限 10 秒）
`watermark`	boolean	否	是否添加右下角"内容由AI生成"水印	`true`、`false`，默认 `false`
`seed`	integer	否	随机数种子	`[0, 2147483647]`

请求头：需携带 Content-Type: application/json 和 Authorization: Bearer $API_KEY。

请求示例

参考生视频（仅参考图像）
支持模型：ViduQ2-Pro-Reference2Video。

bash

curl -X POST 'https://aiping.cn/api/v1/videos' \
-H "Authorization: Bearer $API_KEY" \
-H 'Content-Type: application/json' \
-d '{
  "model": "ViduQ2-Pro-Reference2Video",
  "prompt": "男人坐在靠窗的椅子上，手持吉他，在咖啡厅旁演奏一首舒缓的美国乡村民谣",
  "reference_images": [
    "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260320/knsple/wan-r2v-role-frame.jpg",
    "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qpzxps/wan-r2v-object4.png",
    "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/wfjikw/wan-r2v-backgroud5.png"
  ],
  "duration": 5,
  "size": "1280*720",
  "resolution": "720P",
  "watermark": true
}'

参考生视频（参考图像+视频）
支持模型：ViduQ2-Pro-Reference2Video。

bash

curl -X POST 'https://aiping.cn/api/v1/videos' \
-H "Authorization: Bearer $API_KEY" \
-H 'Content-Type: application/json' \
-d '{
  "model": "ViduQ2-Pro-Reference2Video",
  "prompt": "男人坐在靠窗的椅子上，手持吉他，在咖啡厅旁演奏一首舒缓的美国乡村民谣",
  "reference_video_urls": [
    "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qigswt/wan-r2v-role2.mp4"
  ],
  "reference_images": [
    "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qpzxps/wan-r2v-object4.png",
    "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/wfjikw/wan-r2v-backgroud5.png"
  ],
  "duration": 5,
  "size": "1280*720",
  "resolution": "720P",
  "watermark": true
}'

成功响应

json

{
  "id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
  "status": "queued",
  "model": "ViduQ2-Pro-Reference2Video",
  "seconds": 5,
  "size": "960*528",
  "provider": "阿里云百炼"
}

字段说明：id、status、model 始终返回；seconds、size、provider 仅在值非空时出现。status 默认值为 "queued"。

异常响应

创建任务失败，请参见错误信息进行解决。

响应参数

参数名	类型	说明
`id`	string	任务 ID，用于查询任务状态与结果
`status`	string	任务状态，默认值为 `queued`
`model`	string	模型名称
`seconds`	integer	视频时长（秒），仅在值非空时出现
`size`	string	视频尺寸，仅在值非空时出现
`provider`	string	服务商名称，仅在值非空时出现

创建任务后，请通过 Vidu 任务查询接口轮询获取结果。

错误码

如果模型调用失败并返回报错信息，请参见错误信息进行解决。

常见问题

Q：size 与 resolution 必须同时传入吗？

A：不必。二者均为可选参数，但推荐同时传入。同时传入可精准控制生成视频的宽高比。

若不同时传入，系统将按以下两种场景处理：

仅传 size：size 会被忽略，系统强制按默认 resolution=720P 及对应默认 size=1280*720 处理。
例如：接口返回 size="1280*720", SR=720。
仅传 resolution：按指定分辨率档位及该档位对应 16:9 比例输出。
例如：resolution=540P 时返回 size="960*528", SR=540；resolution=1080P 时返回 size="1920*1080", SR=1080。

Vidu 任务查询

所有 Vidu 视频生成任务共用相同的查询接口，创建任务后使用返回的 id 轮询获取结果。

查询接口

GET https://aiping.cn/api/v1/videos/{task_id}

说明

轮询建议：视频生成过程约需数分钟，建议采用轮询机制，并设置合理查询间隔（如 15 秒）。
任务状态流转：queued（排队中）→ in_progress（处理中）→ completed（完成）/ failed（失败）。
task_id 有效期：24 小时，超时后将无法查询结果，接口将返回 UNKNOWN。

请求示例

bash

curl -X GET https://aiping.cn/api/v1/videos/{task_id} \
--header "Authorization: Bearer $API_KEY"

请求参数

参数名	类型	必填	说明
`task_id`	string	是	任务 ID，创建任务时返回的 `id` 字段（URL 路径参数）

请求头：需携带 Authorization: Bearer $API_KEY 进行身份认证。

响应体（任务完成）

json

{
  "id": "2846881f-0496-4288-947f-xxxxxx",
  "status": "completed",
  "created_at": "2026-03-27T14:25:32.057000Z",
  "completed_at": "2026-03-27T14:28:29.600000Z",
  "video_url": "https://prod-ss-vidu.s3.cn-northwest-1.amazonaws.com.cn/xxx.mp4?xxxx",
  "usage": {
    "seconds": 5.0,
    "video_count": 1,
    "size": "988*932"
  },
  "raw_response": { ... }
}

响应体（任务失败）

json

{
  "id": "86ecf553-d340-4e21-af6e-a0c6a421c010",
  "status": "failed",
  "created_at": "2026-03-27T14:25:32.057000Z",
  "error": "The size is not match xxxxxx"
}

响应参数说明

字段	类型	说明
`id`	string	任务 ID
`status`	string	任务状态：`queued`（排队中）、`in_progress`（处理中）、`completed`（完成）、`failed`（失败）
`created_at`	string	任务创建时间，ISO 8601 格式
`completed_at`	string	任务完成时间（仅完成时返回）
`video_url`	string	生成的视频 URL（仅完成时返回）
`usage.seconds`	float	视频时长（秒）
`usage.video_count`	int	生成的视频数量
`usage.size`	string	视频尺寸
`raw_response`	object	服务商原始响应
`error`	string	错误信息（仅失败时返回）

支持的视频尺寸

Wan 系列支持的视频尺寸

720P 尺寸：

1280*720（横屏）
720*1280（竖屏）
960*960（方形）
1088*832
832*1088

1080P 尺寸：

1920*1080（横屏）
1080*1920（竖屏）
1440*1440（方形）
1632*1248
1248*1632

size 参数支持 x 或 * 作为分隔符，如 1280x720 会自动转换为 1280*720。

Vidu 支持的视频尺寸

Vidu 的 size 取值取决于 resolution 分辨率档位：

分辨率档位	宽高比	size 取值（宽*高）
540P	16:9	`960*528`（默认）
	9:16	`528*960`
	1:1	`720*720`
	4:3	`816*608`
	3:4	`608*816`
720P	16:9	`1280*720`（默认）
	9:16	`720*1280`
	1:1	`960*960`
	4:3	`1104*816`
	3:4	`816*1104`
1080P	16:9	`1920*1080`（默认）
	9:16	`1080*1920`
	1:1	`1440*1440`
	4:3	`1674*1238`
	3:4	`1238*1674`

查询任务

网络协议	请求地址	请求方法	请求格式	响应格式
https	`/videos/{task_id}`	GET	-	application/json

请求头

字段	值	描述
Authorization	Bearer	鉴权信息

请求路径参数

参数名	类型	必填	说明
`task_id`	string	是	任务 ID，创建任务时返回的 `id` 字段

查询参数（可选）

参数名	类型	必填	说明
`provider`	string	否	服务商名称，可选。如果任务不在缓存中可加快查询

响应体（任务进行中）

json

{
  "id": "task_abc123",
  "status": "in_progress",
  "created_at": "2025-01-13T10:00:00.000000Z"
}

响应体（任务完成）

json

{
  "id": "task_abc123",
  "status": "completed",
  "created_at": "2025-01-13T10:00:00.000000Z",
  "completed_at": "2025-01-13T10:03:00.000000Z",
  "video_url": "https://example.com/output.mp4",
  "usage": {
    "seconds": 5.0,
    "video_count": 1,
    "size": "1280*720"
  },
  "raw_response": { ... }
}

响应参数说明

字段	类型	说明
`id`	string	任务 ID
`status`	string	任务状态：`queued`（排队中）、`in_progress`（处理中）、`completed`（完成）、`failed`（失败）
`created_at`	string	任务创建时间
`completed_at`	string	任务完成时间（仅完成时返回）
`video_url`	string	生成的视频 URL（仅完成时返回）
`usage.seconds`	float	视频时长（秒）
`usage.video_count`	int	生成的视频数量
`usage.size`	string	视频尺寸
`raw_response`	object	服务商原始响应
`error`	string	错误信息（仅失败时返回）

通用说明

异步任务：视频生成是异步任务，提交后返回任务 ID，需要轮询查询任务状态。
尺寸格式：size 参数中的分隔符 x 会自动转换为 *，如 1280x720 → 1280*720。
默认值：prompt_extend 默认 true，shot_type 默认 multi。
参数透传：未知参数不会被过滤，会透传给服务商 API。
格式优先级：服务商原生格式优先于标准格式。如果同时传入原生格式和标准格式参数，将使用原生格式。

服务商原生格式（透传）：

Vidu 系列模型支持以阿里云百炼的原生请求体格式传参，系统会将请求体直接透传给服务商 API。使用原生格式时，需同时提供 model 和 input 字段，parameters 为可选。若同时传入原生格式和标准格式参数，将优先使用原生格式。

json

{
  "model": "viduq3-turbo-text2video",
  "input": {
    "prompt": "一只小猫在月光下奔跑"
  },
  "parameters": {
    "size": "960*528",
    "resolution": "540P",
    "duration": 5,
    "watermark": true
  }
}

参数名	类型	必填	说明
`model`	string	是	标准模型名称，如 `viduq3-turbo-text2video`
`input`	object	是	输入参数，包含 `prompt` 等字段，结构与阿里云百炼 API 一致
`parameters`	object	否	可选的生成参数，如 `size`、`resolution`、`duration`、`watermark` 等

MiniMax

阿里云百炼 视频生成 API 文档 ​

概述 ​

Wan2.6-T2V 文生视频 ​

请求参数 ​

请求示例 ​

响应示例 ​

注意事项 ​

Wan2.6-I2V 图生视频 ​

请求参数 ​

请求示例 ​

响应示例 ​

注意事项 ​

Wan2.6-R2V 视频生视频 ​

请求参数 ​

请求示例 ​

响应示例 ​

注意事项 ​

Vidu 文生视频 ​

请求参数 ​

请求示例 ​

响应示例 ​

注意事项 ​

Vidu 图生视频-基于首帧 ​

请求参数 ​

请求示例 ​

响应参数 ​

Vidu 首尾帧生视频 ​

请求参数 ​

请求示例 ​

成功响应 ​

异常响应 ​

响应参数 ​

错误码 ​

常见问题 ​

Q：media数组中首帧和尾帧的顺序是否有要求？ ​

Q：首帧和尾帧图像的分辨率是否需要一致？ ​

Vidu 参考生视频 ​

请求参数 ​

请求示例 ​

成功响应 ​

异常响应 ​

响应参数 ​

错误码 ​

常见问题 ​

Vidu 任务查询 ​

查询接口 ​

请求示例 ​

请求参数 ​

响应体（任务完成） ​

响应体（任务失败） ​

响应参数说明 ​

支持的视频尺寸 ​

Wan 系列支持的视频尺寸 ​

Vidu 支持的视频尺寸 ​

查询任务 ​

请求头 ​

请求路径参数 ​

查询参数（可选） ​

响应体（任务进行中） ​

响应体（任务完成） ​

响应参数说明 ​

通用说明 ​

服务商原生格式（透传）： ​

阿里云百炼视频生成 API 文档

概述

Wan2.6-T2V 文生视频

请求参数

请求示例

响应示例

注意事项

Wan2.6-I2V 图生视频

请求参数

请求示例

响应示例

注意事项

Wan2.6-R2V 视频生视频

请求参数

请求示例

响应示例

注意事项

Vidu 文生视频

请求参数

请求示例

响应示例

注意事项

Vidu 图生视频-基于首帧

请求参数

请求示例

响应参数

Vidu 首尾帧生视频

请求参数

请求示例

成功响应

异常响应

响应参数

错误码

常见问题

Q：media数组中首帧和尾帧的顺序是否有要求？

Q：首帧和尾帧图像的分辨率是否需要一致？

Vidu 参考生视频

请求参数

请求示例

成功响应

异常响应

响应参数

错误码

常见问题

Vidu 任务查询

查询接口

请求示例

请求参数

响应体（任务完成）

响应体（任务失败）

响应参数说明

支持的视频尺寸

Wan 系列支持的视频尺寸

Vidu 支持的视频尺寸

查询任务

请求头

请求路径参数

查询参数（可选）

响应体（任务进行中）

响应体（任务完成）

响应参数说明

通用说明

服务商原生格式（透传）：