POST
/
v3
/
async
/
img2video
curl --request POST \
  --url https://api.ppinfra.com/v3/async/img2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '{
  "extra": {
    "response_video_type": "<string>"
  },
  "model_name": "<string>",
  "image_file": "<string>",
  "frames_num": 123,
  "frames_per_second": 123,
  "image_file_resize_mode": "<string>",
  "steps": 123,
  "motion_bucket_id": 123,
  "cond_aug": 123,
  "enable_frame_interpolation": true
}'
{
  "task_id": "<string>"
}

图生视频 API 能基于用户输入的图片生成视频。

请求头

Content-Type
string
required

枚举值: application/json

Authorization
string
required

Bearer 身份验证格式,例如:Bearer {{API 密钥}}。

请求体

extra
object

额外参数

model_name
string
required

指定视频生成模型。Enum: SVD-XT, SVD

image_file
string
required

原始图片的 base64 编码内容,支持的最大分辨率为 2048 * 2048,文件最大不超过 30 Mb。

frames_num
integer
required

视频帧数,当 model_name 设置为 SVD_XT 时,frames_num 设置为 25,当 model_name 设置为 SVD, frames_num 设置为 14。

frames_per_second
integer
required

帧率,即每秒帧数。帧率越大,视频越流畅。目前只能设置为固定值 6。

image_file_resize_mode
string
required

图片文件调整尺寸的模式。当设置为 ORIGINAL_RESOLUTION 时,表示保持原始图像大小,但最终的视频分辨率小于等于 576x1024;当设置为 CROP_TO_ASPECT_RATIO 时,表示保持图像的原始比例,并将其裁剪至 576x1024 分辨率内。Enum: ORIGINAL_RESOLUTION, CROP_TO_ASPECT_RATIO

steps
integer
required

迭代步数,视频生成迭代数,取值范围:[1, 50]。

motion_bucket_id
integer

选择合适的 motion bucket 可以根据输入图像的特定特征或主题定制动画效果。范围[1, 255]。

cond_aug
number

值越高,视频与条件图像的相似度越低。增加此值还会增大生成视频中的运动幅度。范围[0, 1]。

enable_frame_interpolation
boolean

是否开启插帧,支持到 24 fps。此功能通过生成中间帧来平滑运动,增强视频序列的流畅性和连续性。这对于将较低帧率的镜头转换为更具电影感的帧率特别有用。

响应参数

task_id
string
required

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