You need to enable JavaScript to run this app.
Lake AI Service

Lake AI Service

Copy page
Download PDF
Video processing
Video frame interpolation
Copy page
Download PDF
Video frame interpolation

The video frame interpolation operator is used to increase the frame rate of input videos by generating intermediate frames to enhance playback smoothness, and outputs a new high-frame-rate video file. You can specify the target frame rate as needed, select the interpolation mode, and decide whether to retain the original audio stream. This operator is suitable for scenarios that require improved motion smoothness, exporting higher frame rate versions, or standardizing video output specifications.

Operator introduction

operator_id:las_video_interpolation

Limitations

  • target_fps must be greater than 0 and cannot be lower than the source video frame rate.

Core capabilities

  • Supports three interpolation modes: ultra-fast, fast, and medium, balancing speed and quality. Flexible settings allow low-frame-rate videos to be increased to the specified target frame rate.
  • Automatically retains the original audio stream, eliminating the need for additional audio-video merging operations.
  • Supports output to TOS, with results automatically uploaded.

Supported regions

  • Beijing: cn-beijing

Operator performance

  • Total processing time depends on video duration, processing mode, and network environment.
  • The operator relies on CUDA GPU and video frame interpolation models. Higher resolution, higher target frame rate, and longer videos result in increased overall processing time.
  • It is recommended to access TOS sources and write TOS results within the Volcano Engine intranet environment for more stable network performance.

Input and output requirements

Input requirements

Details

Detailed requirements

Supported input data modalities

  • Video

Input format: Video

  • Size: Video duration must not exceed 3 hours, and file size must not exceed 10 GB.

Input path requirements

Provide input data to the operator via the request parameter video_url. Currently, two methods are supported: public URL and TOS path.

  • Public URL: A video URL accessible via the public internet, in the format http/https.
  • TOS path: After uploading the data to a TOS Bucket under the same primary account and region as the current LAS service, you can provide the TOS path in the format tos://bucket_name/demo.

Output requirements

Details

Detailed requirements

Output data modalities

  • Video

Output path: TOS

Specify the storage path for the operator's output results via the request parameter output_tos_path. Currently, only TOS paths are supported.

  • TOS path: A writable TOS Bucket directory under the same primary account and region as the LAS service.

Billing information
  • Billing standards

    Sub-items
    Billing standard description

    Billing item

    Billing is calculated based on the duration of the output video. When billing, the duration is adjusted using a frame rate coefficient according to the output video frame rate.

    Billing type

    Pay-as-you-go, unit: CNY/minute, billed hourly based on actual usage.

    Unit price

    The unit price depends on the selected video frame interpolation mode and is tiered according to the output video resolution range.

  • Billing details
    Billing formula: Total cost = Unit price * Billable usage = Unit price * (Video duration * frame rate coefficient)

    Sub-scenarios
    Output video resolution tier range
    Unit price
    Frame rate coefficient

    Mode: ultra-fast/fast

    Output video resolution ≤ 720p

    0.5 CNY/minute

    Different video frame rates correspond to different frame rate coefficients:

    • Actual frame rate ≤ 30 fps: coefficient is "1"
    • 30 fps < Actual frame rate ≤ 60 fps: coefficient is "2"
    • 60 fps < Actual frame rate ≤ 90 fps: coefficient is "3"
    • 90 fps < Actual frame rate: coefficient is "Frame rate/30", rounded up

    720p < Output video resolution ≤ 1080p

    1.5 CNY/minute

    1080p < Output video resolution ≤ 1440p

    2 CNY/minute

    1440p < Output video resolution

    5 CNY/minute

    Mode: medium

    Output video resolution ≤ 720p

    2 CNY/minute

    Different video frame rates correspond to different frame rate coefficients:

    • Actual frame rate ≤ 30 fps: coefficient is "1"
    • 30 fps < Actual frame rate ≤ 60 fps: coefficient is "2"
    • 60 fps < Actual frame rate ≤ 90 fps: coefficient is "3"
    • 90 fps < Actual frame rate: coefficient is "Frame rate/30", rounded up

    720p < Output video resolution ≤ 1080p

    4 CNY/minute

    1080p < Output video resolution ≤ 1440p

    7 CNY/minute

    1440p < Output video resolution

    12 CNY/minute

  • Billing example: When using the medium mode for video frame interpolation, with the actual output video resolution at 720p, a video duration of 5 minutes, and a frame rate of 120 fps:

    • The frame rate coefficient is: 120/30 = 4.
    • Cost = Unit price * (Video duration * coefficient) = 2 CNY/minute * (5 minutes * 4) = 40 CNY

Rest API invocation

Interface description

Invoke the video frame interpolation operator to submit asynchronous tasks to increase the frame rate of input videos and upload the results.

Submit (submit task)

You can call the Submit interface to submit asynchronous tasks.

Request parameters

Parameter
Type
Required
Example value
Description
operator_id
string
Yes
las_video_interpolation
Operator ID.
operator_version
string
Yes
v1
Operator version.
data
VideoInterpolationReqParams
Yes
Video frame interpolation request parameters.

Response parameters

Parameter
Type
Example value
Description
metadata
object
Request metadata.

Request example

# Please set OUTPUT_TOS_PATH to a tos path that is writable by this account
export OUTPUT_TOS_PATH="tos://path/to/interpolation_results"

curl --location "https://operator.las.ap-southeast-1.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"
    }
}'

Response example

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

Error code

HttpStatusCode

Error code

Error message

Description

400

Url.Invalid

The url is invalid.

The video URL is invalid.

400

Video.Invalid

The video file is invalid.

The video file is invalid or cannot be parsed.

400

Video.DownloadFailed

Video download failed.

Video download failed.

400

Video.FormatUnsupported

Video format not supported.

Video format not supported.

400

Video.DurationExceeded

Video duration exceeds maximum limit.

Video duration exceeds the maximum limit.

400

Video.FileTooLarge

Video file size exceeds maximum limit.

The video file is too large.

400

Parameter.Invalid

The parameter is invalid.

The parameter is invalid. For example, target_fps is lower than the source video frame rate, mode is invalid, or output_tos_path has an incorrect format.

400

Video.Timeout

Video processing timeout.

Video processing timeout.

400

Video.UploadFailed

Video upload failed.

Failed to upload the output video.

400

Tos.AccessFailed

TOS access failed.

TOS access failed.

401

Authorization.Missing

Missing Authorization.

Authorization is missing.

401

ApiKey.InValid

The api key is invalid.

The API is invalid.

500

Internal.ServerError

Internal server error.

Internal server error, such as model inference failure or failure to generate the output video.

Poll (query task)

You can call the Poll API to query the execution status and result of the video frame interpolation task. When metadata.task_status is COMPLETED, you can obtain the output video URL from the data field in the response.

Request parameters

Name

Type

Required

Example value

Description

operator_id

string

Yes

las_video_interpolation

Operator ID.

operator_version

string

Yes

v1

Operator version.

task_id

string

Yes

task-xxx

Task ID returned by the Submit API.

Response parameters

Parameter
Type
Example value
Description
metadata
object
Request metadata.
data
VideoInterpolationResponse
Returned data (result URL, whether processed, and so on).

Request example

curl --location "https://operator.las.ap-southeast-1.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"
}'

Response example

{
    "metadata": {
        "task_id": "task-20260413190000-abc123",
        "task_status": "COMPLETED",
        "submit_time": "2026-07-21T16:04:06+08:00",
        "end_time": "2026-07-21T16:04:06+08:00",
        "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"
    }
}

Error code

HttpStatusCode

Error code

Error message

Description

400

Url.Invalid

The url is invalid.

The video URL is invalid.

400

Video.Invalid

The video file is invalid.

The video file is invalid or cannot be parsed.

400

Video.DownloadFailed

Video download failed.

Video download failed.

400

Video.FormatUnsupported

Video format not supported.

Video format not supported.

400

Video.DurationExceeded

Video duration exceeds maximum limit.

Video duration exceeds the maximum limit.

400

Video.DurationTooShort

Video duration is too short.

Video duration is too short.

400

Video.FileTooLarge

Video file size exceeds maximum limit.

The video file is too large.

400

Parameter.Invalid

The parameter is invalid.

The parameter is invalid.

400

Video.Timeout

Video processing timeout.

Video processing timeout.

400

Video.UploadFailed

Video upload failed.

Failed to upload the output video.

400

Tos.AccessFailed

TOS access failed.

TOS access failed.

401

Authorization.Missing

Missing Authorization.

Authorization is missing.

401

ApiKey.InValid

The api key is invalid.

The API is invalid.

500

Internal.ServerError

Internal server error.

Internal server error.

Last updated: 2026.07.28 16:03:41