您可以利用视频插帧算子对输入视频进行升帧处理，提升画面流畅度，并将结果自动上传到指定的对象存储（TOS）目录。该算子适合需要提升运动画面平滑度、导出更高帧率版本或统一视频输出规格的场景。本文介绍算子能力、使用前提、使用建议，以及 Rest API（Application Programming Interface）调用方式。

视频插帧算子用于对输入视频进行升帧处理，通过生成中间帧提升画面流畅度，并输出新的高帧率视频文件。您可以按需指定目标帧率、选择插帧模式，并决定是否保留原始音频流。

使用限制 #

• 输入视频需要可被服务访问，支持 http/https 和 tos://。
• output_tos_path 必须是当前账号可写的 TOS 目录。
• target_fps 必须大于 0，且不能小于源视频帧率。
• 当前版本视频时长限制为 3 小时，视频大小限制为 10GB。
• 算子依赖 CUDA GPU 和视频插帧模型，分辨率越高、目标帧率越高、视频越长，整体耗时越高。

核心功能 #

• 支持将低帧率视频提升到指定目标帧率，输出更流畅的视频结果。
• 支持 ultra-fast、fast、medium 三种插帧模式，兼顾速度与效果。
• 支持自动保留原视频音频流，无需额外音视频拼接操作。
• 支持输出到 TOS，结果自动上传。

性能说明 #

• 总耗时与视频时长、处理模式、网络环境相关。
• 建议在火山内网环境下访问 TOS 源与写入 TOS 结果以获得更稳定的网络性能。

接口说明 #

调用视频插帧算子提交异步任务，支持对输入视频进行升帧并上传结果。

Submit（提交任务） #

您可以调用 Submit 接口提交异步任务。

请求参数 #

返回数据 #

请求示例 #

# 请将 OUTPUT_TOS_PATH 设置为本账号上可写入的 tos 路径
export OUTPUT_TOS_PATH="tos://path/to/interpolation_results"

curl --location "https://las.cn-beijing.volces.com/api/v1/submit" --header "Content-Type: application/json" --header "Authorization: Bearer $$LAS_API_KEY" --data '{
    "operator_id": "las_video_interpolation",
    "operator_version": "v1",
    "data": {
        "video_url": "https://${LAS_TOS_BUCKET}.${TOS_ENDPOINT}/operator_cards_serving/public/${LAS_ENVIRONMENT}/las_video_interpolation/v1/sample_input.mp4",
        "output_tos_path": "$$OUTPUT_TOS_PATH",
        "target_fps": 60.0,
        "mode": "fast"
    }
}'

返回示例 #

{
  "metadata": {
    "task_id": "task-20260413190000-abc123",
    "task_status": "PENDING",
    "business_code": "0",
    "error_msg": ""
  }
}

错误码 #

Poll（查询任务） #

您可以调用 Poll 接口查询视频插帧任务的执行状态和结果。当 metadata.task_status 为 COMPLETED 时，您可以在返回的 data 字段中获取输出视频地址。

请求参数 #

返回数据 #

请求示例 #

curl --location "https://las.cn-beijing.volces.com/api/v1/poll" --header "Content-Type: application/json" --header "Authorization: Bearer $$LAS_API_KEY" --data '{
    "operator_id": "las_video_interpolation",
    "operator_version": "v1",
    "task_id": "task-20260413190000-abc123"
}'

返回示例 #

{
  "metadata": {
    "task_id": "task-20260413190000-abc123",
    "task_status": "COMPLETED",
    "business_code": "0",
    "error_msg": ""
  },
  "data": {
    "output_video_tos_url": "tos://path/to/interpolation_results/sample_output_60fps.mp4",
    "output_video_url": "https://path/to/interpolation_results/sample_output_60fps.mp4"
  }
}

错误码 #