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 以获取生成结果

文生视频人脸融合