Vidu 官方格式
Vidu 视频生成接口说明,兼容官方 ent/v2 路径
Vidu 官方格式
零度API 支持按 Vidu 官方接口格式调用视频生成能力。将请求域名替换为 api000.com,并使用零度API 的 Bearer Token 即可接入。
基本信息
| 项目 |
说明 |
| Base URL |
https://api000.com |
| 鉴权方式 |
Authorization: Bearer sk-xxxxxxxxxxxxxxxx |
| 请求格式 |
Content-Type: application/json |
| 任务模式 |
异步任务,先创建任务,再查询结果 |
视频接口
| 能力 |
方法 |
路径 |
| 文生视频 |
POST |
/ent/v2/text2video |
| 图生视频 |
POST |
/ent/v2/img2video |
| 参考生视频 |
POST |
/ent/v2/reference2video |
| 首尾帧生视频 |
POST |
/ent/v2/start-end2video |
| 查询任务结果 |
GET |
/ent/v2/tasks/{id}/creations |
其他 Vidu 能力
| 能力 |
方法 |
路径 |
| 参考生图 |
POST |
/ent/v2/reference2image |
| 文生音频 |
POST |
/ent/v2/text2audio |
| 语音合成 |
POST |
/ent/v2/audio-tts |
调用流程
- 调用创建接口,返回
task_id
- 使用
task_id 调用 /ent/v2/tasks/{id}/creations
- 当
state 为 success 时,从 creations[0].url 获取生成文件
# 1. 创建参考生视频任务
curl https://api000.com/ent/v2/reference2video \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
-d '{
"model": "viduq3",
"subjects": [
{
"id": "cat",
"images": ["https://example.com/cat.png"]
}
],
"prompt": "一只可爱的@cat在草地上奔跑,阳光明媚",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
}'
# 2. 查询结果
curl https://api000.com/ent/v2/tasks/911084878697623552/creations \
-H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx"
常用参数
| 参数 |
类型 |
说明 |
model |
string |
Vidu 模型名称,例如 viduq3、viduq3-mix |
prompt |
string |
视频提示词 |
images |
string[] |
图生视频、非主体参考生视频使用的图片 URL |
subjects |
array |
主体参考生视频使用的主体数组 |
duration |
integer |
视频时长,未传时按模型默认值处理 |
resolution |
string |
清晰度,建议显式传入 540p、720p 或 1080p |
aspect_ratio |
string |
画面比例,例如 16:9、9:16、1:1 |
movement_amplitude |
string |
运动幅度,例如 auto、standard |
seed |
integer |
随机种子,便于复现相近结果 |
payload |
string |
业务侧自定义追踪字段 |
建议创建任务时明确传入 resolution,便于按对应清晰度计费和排查。