POST
/
v3
/
async
/
vidu-2.0-startend2video
Vidu 2.0 首末帧
curl --request POST \
  --url https://api.ppinfra.com/v3/async/vidu-2.0-startend2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '{
  "images": [
    "<string>"
  ],
  "prompt": "<string>",
  "duration": 123,
  "seed": 123,
  "resolution": "<string>",
  "movement_amplitude": "<string>",
  "bgm": true
}'
{
  "task_id": "<string>"
}
Vidu 2.0 首末帧通过起始帧和结束帧生成动态视频,融入创意故事叙述和动画效果。
这是一个异步API,只会返回异步任务的 task_id。您应该使用该 task_id 请求 查询任务结果 API 来检索视频生成结果。

请求头

Content-Type
string
required
枚举值: application/json
Authorization
string
required
Bearer 身份验证格式,例如:Bearer {{API 密钥}}。

请求体

images
string[]
required
两张图像:第一张为起始帧,第二张为结束帧。注意事项:
  1. 支持公共 URL 或 Base64 格式
  2. 宽高比必须接近:起始帧与结束帧的比例必须在 0.8~1.25 之间
  3. 支持格式:png、jpeg、jpg、webp
  4. 最大尺寸:50MB
  5. base64 解码后的长度必须小于 10MB,且必须包含适当的内容类型字符串。例如:
data:image/png;base64,{base64_encode}
prompt
string
提示词描述,最大 1500 个字符。
duration
integer
视频持续时间(秒)。默认为 4 秒,可选 4 秒或 8 秒。
seed
integer
视频生成的随机种子。
  • 默认为随机种子数值
  • 手动设置的值将覆盖默认的随机种子
resolution
string
基于时长的分辨率选项:
  • 4秒:默认 360p,可选 360p720p1080p
  • 8秒:默认 720p,可选 720p
movement_amplitude
string
画面中物体的运动幅度。默认值:auto
可选值:autosmallmediumlarge
bgm
boolean
是否为生成的视频添加背景音乐。默认值:false
可选值:truefalse
当设置为 true 时,系统将自动添加合适的 BGM。BGM 无时长限制,系统会自动适配。

响应

task_id
string
required
异步任务的 task_id。您应该使用该 task_id 请求 查询任务结果 API 以获取生成结果