主题模式
Vidu 首尾帧 API 文档
根据首帧图和尾帧图生成视频；images 固定传 2 张图，第一张为首帧，第二张为尾帧。
Vidu 官方接口为 POST https://api.vidu.cn/ent/v2/start-end2video。
服务商支持
| 渠道 | 说明 |
|---|---|
| Vidu 官方 | 默认 |
创建任务
| 网络协议 | 请求地址 | 请求方法 | 请求格式 | 响应格式 |
|---|---|---|---|---|
| https | /videos/vidu/start-end2video | POST | application/json | application/json |
请求头
| 字段 | 值 | 描述 |
|---|---|---|
| Content-Type | application/json | 数据交换格式 |
| Authorization | Bearer | aiping 平台鉴权 |
请求体参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型名称。可选值：viduq3-turbo、viduq3-pro、viduq3-pro-fast、viduq2-pro、viduq2-turbo |
images | array[string] | 是 | 固定 2 张图。第一张为首帧图，第二张为尾帧图。支持图片 URL 或 Base64 |
prompt | string | 否 | 文本提示词，生成视频的文本描述，字符长度不能超过 5000 |
is_rec | bool | 否 | 是否使用推荐提示词。true 时系统自动推荐并使用提示词，模型不考虑 prompt；每个任务多消耗 10 积分 |
duration | int | 否 | 视频时长，默认值和可选范围依模型而定 |
seed | int | 否 | 随机种子。不传或传 0 时使用随机数 |
resolution | string | 否 | 分辨率，默认值和可选范围依模型及时长而定 |
movement_amplitude | string | 否 | 运动幅度，默认 auto。可选：auto、small、medium、large；q2、q3 系列模型不生效 |
audio | bool | 否 | 是否使用音视频直出能力，默认 true。仅 q3 系列模型支持 |
bgm | bool | 否 | 是否添加背景音乐，默认 false。q3 系列模型不生效 |
payload | string | 否 | 透传参数，不做处理，仅数据传输，最多 1048576 个字符 |
off_peak | bool | 否 | 错峰模式，默认 false。true 为错峰生成，false 为即时生成 |
watermark | bool | 否 | 是否添加水印。默认不添加 |
wm_position | int | 否 | 水印位置：1 左上角、2 右上角、3 右下角、4 左下角。默认 3 |
wm_url | string | 否 | 水印图片 URL。不传时使用默认水印 |
meta_data | string | 否 | 元数据标识，JSON 格式字符串，透传字段。不传时默认使用 Vidu 生成的元数据标识 |
callback_url | string | 否 | 回调地址。任务状态变化时，Vidu 以 POST 请求回调该地址 |
extra_body.provider | object | 否 | 路由，见 路由策略 |
模型说明：
| 模型 | 说明 |
|---|---|
viduq3-turbo | 对比 viduq3-pro，生成速度更快 |
viduq3-pro | 高效生成优质音视频内容，让视频内容更生动、更形象、更立体，效果更好 |
viduq3-pro-fast | 高效生成优质音视频内容，生成速度更快，性价比高 |
viduq2-pro | 新模型，效果好，细节丰富 |
viduq2-turbo | 新模型，效果好，生成快 |
时长与分辨率：
| 模型/时长 | duration | resolution |
|---|---|---|
viduq3-pro、viduq3-turbo | 默认 5，可选 1-16 | 默认 720p，可选 540p、720p、1080p |
viduq2-pro-fast | 默认 5，可选 1-8 | 默认 720p，可选 720p、1080p |
viduq2-pro、viduq2-turbo | 默认 5，可选 1-8 | 默认 720p，可选 540p、720p、1080p |
viduq1、viduq1-classic | 默认 5，可选 5 | 默认 1080p，可选 1080p |
vidu2.0 4 秒 | 默认 4，可选 4、8 | 默认 360p，可选 360p、720p、1080p |
vidu2.0 8 秒 | 默认 4，可选 4、8 | 默认 720p，可选 720p |
图片要求：
- 首尾帧两张图分辨率需相近，首帧图分辨率 / 尾帧图分辨率需在 0.8-1.25 之间。
- 图片比例需小于 1:4 或 4:1。
- 支持
png、jpeg、jpg、webp。 - 单张图片大小不超过 50 MB。
- HTTP POST body 不超过 20 MB；Base64 编码需包含内容类型字符串，如
data:image/png;base64,{base64_encode}。
回调状态：
| 状态 | 说明 |
|---|---|
processing | 任务处理中 |
success | 任务完成；如发送失败，回调三次 |
failed | 任务失败；如发送失败，回调三次 |
查询任务（标准异步）
提交后使用 task-query.md 中的统一查询接口：
| 网络协议 | 请求地址 | 请求方法 |
|---|---|---|
| https | /videos/vidu/tasks/{task_id}/creations | GET |
响应为 creations 形态（state、creations[].url、credits 等）。
请求示例
json
{
"model": "viduq3-pro-fast",
"images": [
"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png",
"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/scene-template/hug.jpeg"
],
"prompt": "从第一张图平滑过渡到第二张图，镜头保持稳定，动作自然连贯",
"audio": false,
"duration": 4,
"resolution": "720p",
"off_peak": false,
"watermark": false,
"payload": "test-vidu-start-end2video"
}返回结构示例
json
{
"task_id": "your_task_id_here",
"state": "created",
"model": "viduq3-pro-fast",
"images": [
"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png",
"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/scene-template/hug.jpeg"
],
"prompt": "从第一张图平滑过渡到第二张图，镜头保持稳定，动作自然连贯",
"duration": 4,
"seed": 123456,
"resolution": "720p",
"audio": false,
"bgm": false,
"movement_amplitude": "auto",
"payload": "test-vidu-start-end2video",
"off_peak": false,
"watermark": false,
"credits": 0,
"created_at": "2025-01-01T15:41:31.968916Z",
"aiping_id": "string"
}注意事项
- 错峰模式积分消耗更低；ViduQ2 错峰价格为正常生成价格的一半，如果积分存在小数则向上取整。错峰任务会在 48 小时内生成，未完成会自动取消并返还积分。
- 积分与人民币换算比例为：
1 积分 = 0.03125 元。 - 使用
watermark后，可通过查询任务接口返回的watermarked_url获取带水印视频。 - Vidu 回调采用签名算法认证，详见 Vidu 官方回调签名算法文档。