04-首尾帧
首尾帧
POST https://platform.shuyanai.com/vidu/ent/v2/start-end2video请求参数
请求头
| 头部 | 必填 | 说明 |
|---|---|---|
Content-Type | 是 | application/json |
Authorization | 是 | Bearer sk-xxx |
请求体
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | String | 是 | 模型名称。可选值：viduq3-turbo、viduq3-pro、viduq2-pro-fast、viduq2-pro、viduq2-turbo、viduq1、viduq1-classic、vidu2.0。当前在售型号以模型广场为准 |
images | Array[String] | 是 | 首尾帧图像，2 张，第一张为首帧，第二张为尾帧。 - 首尾帧分辨率比值需在 0.8–1.25 之间，比例需小于 1:4 或 4:1 - 支持图片 Base64 编码或 URL - 支持 png、jpeg、jpg、webp 格式 - 图片大小不超过 50 MB - POST body 不超过 20 MB，Base64 须含内容类型前缀 |
prompt | String | 否 | 文本提示词，不超过 5000 个字符。 注：使用 is_rec 推荐提示词时，模型忽略此参数 |
is_rec | Bool | 否 | 是否使用推荐提示词。启用后每个任务多消耗 10 个 Vidu 积分 |
duration | Int | 否 | 视频时长（秒）： - viduq3-pro、viduq3-turbo：默认 5，可选 1–16- viduq2-pro-fast、viduq2-pro、viduq2-turbo：默认 5，可选 1–8- viduq1、viduq1-classic：默认 5，可选 5- vidu2.0：默认 4，可选 4、8 |
seed | Int | 否 | 随机种子。不传或传 0 时使用随机数 |
resolution | String | 否 | 分辨率： - viduq3-pro、viduq3-turbo（1–16 秒）：默认 720p，可选 540p、720p、1080p- viduq2-pro-fast（1–8 秒）：默认 720p，可选 720p、1080p- viduq2-pro、viduq2-turbo（1–8 秒）：默认 720p，可选 540p、720p、1080p- viduq1、viduq1-classic（5 秒）：默认 1080p，可选 1080p- vidu2.0（4 秒）：默认 360p，可选 360p、720p、1080p- vidu2.0（8 秒）：默认 720p，可选 720p |
movement_amplitude | String | 否 | 运动幅度，默认 auto。注：q2、q3 系列模型不生效 |
audio | Bool | 否 | 是否使用音视频直出。仅 q3 系列模型支持，默认 true |
bgm | Bool | 否 | 是否添加背景音乐，默认 false。注：q3 系列不生效 |
off_peak | Bool | 否 | 错峰模式，默认 false |
watermark | Bool | 否 | 是否添加水印，默认不加 |
wm_position | Int | 否 | 水印位置：1 左上，2 右上，3 右下（默认），4 左下 |
wm_url | String | 否 | 自定义水印图片 URL |
payload | String | 否 | 透传参数，最多 1048576 个字符 |
meta_data | String | 否 | 元数据标识，JSON 格式字符串，透传字段 |
callback_url | String | 否 | 回调地址 |
请求示例
响应参数
| 字段 | 类型 | 说明 |
|---|---|---|
task_id | String | 任务 ID，用于查询任务 |
state | String | 处理状态：created、queueing、processing、success、failed |
model | String | 本次调用的模型名称 |
prompt | String | 提示词 |
images | Array[String] | 图像参数 |
duration | Int | 视频时长 |
seed | Int | 随机种子 |
resolution | String | 分辨率 |
bgm | Bool | 是否添加背景音乐 |
movement_amplitude | String | 运动幅度 |
payload | String | 透传参数 |
off_peak | Bool | 是否使用错峰模式 |
credits | Int | 本次调用消耗的 Vidu 积分数 |
watermark | Bool | 是否使用水印 |
created_at | String | 任务创建时间 |
响应示例
{
"task_id": "{task_id}",
"state": "created",
"model": "viduq3-pro",
"images": [
"https://example.com/start-frame.jpeg",
"https://example.com/end-frame.jpeg"
],
"prompt": "镜头推近小鸟，随后小鸟向右飞走",
"duration": 5,
"seed": 123456,
"resolution": "1080p",
"audio": true,
"payload": "",
"off_peak": false,
"credits": 8,
"created_at": "2025-01-01T15:41:31.968916Z"
}