{
"task_id": "<string>",
"state": "created",
"model": "<string>",
"prompt": "<string>",
"images": [
"<string>"
],
"duration": 123,
"resolution": "<string>",
"created_at": "<string>",
"creations": "<string>"
}创建首尾帧视频(Vidu)
该系列支持OpenAI视频生成格式(详见链接 视频生成Sora兼容格式)。
Vidu 官方视频生成接口,公开路径遵循 Vidu 官方协议。
viduq3-turbo、viduq2、vidu2.0 按各自能力支持文生、图生、首尾帧或参考生视频,也可通过 /v1/videos Sora 兼容格式接入。
Vidu Q4:vidu-q4 固定 720p,vidu-q4-540p 固定 540p,支持生成 3~16 秒视频。至少需要 1 张图片,最多支持 15 张参考图;参考生成可附带最多 3 段 MP3 音频,每段 3~12 秒、最大 50MB。不支持纯文生、指定首尾帧或参考视频。多张图片用于共同参考,不表示首尾位置。可通过 POST /v1/videos、POST /api/v3/contents/generations/tasks,或 Vidu 格式 POST /ent/v2/img2video、POST /ent/v2/reference2video 创建任务。统一入口推荐使用 mode=reference_images;带音频时使用 mode=reference_material。参考音频可用 audio_urls,Seedance 格式也可用标准 content 的 audio_url 项;audio 布尔字段表示生成音频开关,与参考音频 URL 列表分别使用。分辨率须与模型名一致。
补充 Vidu 官方视频生成格式的公开请求骨架、任务查询结构和推荐验证模板,公开路径保持 Vidu 官方端点格式。
支持模型: viduq3-turbo, viduq2, vidu2.0
统一请求字段:
model(string, 必填): Vidu 对外模型名。Vidu Q4 仅支持带图片的图生与参考生视频;Q3/Q2/V2 沿用各自能力。prompt(string, 可选): 视频生成提示词;文生视频必填,图生/首尾帧/参考生视频按业务需要传。images(array[string], 可选): 图片输入。单图图生 1 张;Vidu Q4 参考生成 1~15 张,且图片用于共同参考。旧模型首尾帧与参考数量按各自能力使用。videos(array[string], 可选): 仅按旧模型能力提供视频主体输入;Vidu Q4 不支持参考视频。subjects(array[object], 可选): 参考生视频主体库格式输入,可包含主体名称、图片、视频或音色等字段。duration(integer, 可选): 视频时长,单位秒。viduq3-turbo常用 5 秒,可按官方范围设置。resolution(string, 可选): 输出分辨率,常见值540p、720p、1080p。aspect_ratio(string, 可选): 输出宽高比,文生/参考生视频常用,如16:9、9:16、1:1。seed(integer, 可选): 随机种子。movement_amplitude(string, 可选): 运动幅度,常见值auto、small、medium、large。audio(boolean, 可选): 是否开启音视频直出。audio_urls(array[string], 可选): Vidu Q4 参考音频,最多 3 段 MP3,每段 3~12 秒、最大 50MB;与 audio 布尔开关分开。off_peak(boolean, 可选): 是否使用错峰生成。watermark(boolean, 可选): 是否添加水印。
常见模型/模式差异:
Vidu 文生视频: 支持模型 viduq3-turbo, viduq2, vidu2.0;官方格式文生视频。Vidu 图生视频: 支持模型 viduq3-turbo, viduq2, vidu2.0;官方格式单图图生视频。Vidu 首尾帧生视频: 支持模型 viduq3-turbo, viduq2, vidu2.0;官方格式首尾帧双图生视频。Vidu 参考生视频: 支持模型 viduq3-turbo, viduq2, vidu2.0;官方格式多参考图生视频。
{
"task_id": "<string>",
"state": "created",
"model": "<string>",
"prompt": "<string>",
"images": [
"<string>"
],
"duration": 123,
"resolution": "<string>",
"created_at": "<string>",
"creations": "<string>"
}授权
使用 Bearer Token 认证。
格式: Authorization: Bearer sk-xxxxxx
请求体
Vidu 对外模型名。Vidu Q4 仅支持带图片的图生与参考生视频;Q3/Q2/V2 沿用各自能力。
viduq3-turbo, viduq2, vidu2.0 "viduq3-turbo"
图片输入。单图图生 1 张;Vidu Q4 参考生成 1~15 张,且图片用于共同参考。旧模型首尾帧与参考数量按各自能力使用。
2 elements["https://example.com/input.jpg"]
视频生成提示词;文生视频必填,图生/首尾帧/参考生视频按业务需要传。
"A cinematic product ad with smooth camera motion"
仅按旧模型能力提供视频主体输入;Vidu Q4 不支持参考视频。
视频时长,单位秒。viduq3-turbo 常用 5 秒,可按官方范围设置。
5
输出分辨率,常见值 540p、720p、1080p。
540p, 720p, 1080p "720p"
输出宽高比,文生/参考生视频常用,如 16:9、9:16、1:1。
16:9, 9:16, 4:3, 3:4, 1:1 "16:9"
随机种子。
运动幅度,常见值 auto、small、medium、large。
auto, small, medium, large "auto"
是否开启音视频直出。
Vidu Q4 参考音频,最多 3 段 MP3,每段 3~12 秒、最大 50MB;与 audio 布尔开关分开。
3all, speech_only, sound_effect_only 是否使用错峰生成。
是否添加水印。
1, 2, 3, 4 