tencent cloud

云点播

文档云点播服务端 API 文档Media Processing APIsEditMedia

EditMedia

下载
聚焦模式
字号
最后更新时间： 2026-09-22 22:25:14

1. API Description

Domain name for API request: vod.intl.tencentcloudapi.com.

This API is used to edit a video, such as clipping and splicing, to generate a new on-demand video. Editing features include:

1) Edit a file in VOD to generate a new video.
2) Splice multiple on-demand files to generate a new video.
3) Edit multiple files in on-demand video and then splice them to generate a new video;

  1. Directly generate a new video for one of the streams in VOD;
  2. Edit one of the on-demand streams to generate a new video;
    6) Splice multiple on-demand streams to generate a new video.
    7) Edit multiple streams in VOD and then splice them to generate a new video.

For the generated new video, you can also specify whether to execute task flow on the generated video.

When editing or splicing a live stream, please ensure the stream has ended before operating. Otherwise, the generated video may be incomplete.

If event notification is used, its type is video editing completed.

A maximum of 100 requests can be initiated per second for this API.

We recommend you to use API Explorer
Try it
API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

Parameter Name Required Type Description
Action Yes String Common Params. The value used for this API: EditMedia.
Version Yes String Common Params. The value used for this API: 2018-07-17.
Region No String Common Params. This parameter is not required.
InputType Yes String Type of input video. Valid values: File and Stream.
SubAppId No Integer VOD application ID. For customers who activate VOD after December 25, 2023, this field must be set to the app ID when accessing resources in VOD applications (whether the default application or a newly created application).
FileInfos.N No Array of EditMediaFileInfo Input video file information. Required when InputType is File.
StreamInfos.N No Array of EditMediaStreamInfo Input stream information. Required when InputType is Stream.
Definition No Integer Edit template ID. Valid values: 10 and 20. Default value: 10.
  • 10: During splicing, use the input with the highest resolution as the base;
  • 20: During splicing, use the input with the highest bitrate as the base.
    		•
    ProcedureName No String Task flow name. Fill in if you want to execute a task flow on the generated new video.
    OutputConfig No EditMediaOutputConfig File configuration generated after editing.
    SessionContext No String Identify source context, used to pass through user request information. This field value will be returned in the EditMediaComplete callback and task flow status change callback. Maximum length: 1000 characters.
    TasksPriority No Integer Task Priority. The higher the value, the higher the priority. The value range is from -10 to 10. If left blank, the default value is 0.
    SessionId No String Identification Code for Task Deduplication. If there has been a request with the same identification code within the past 3 days, an error will be returned for the current request. The maximum length is 50 characters. Leaving it blank or using an empty string indicates no deduplication.
    ExtInfo No String Reserved field, used for special purposes.

    3. Output Parameters

    Parameter Name Type Description
    TaskId String Video editing task ID. This can be used to query the status of the edit task (task type: EditMedia).
    RequestId String The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.

    4. Example

    Example1 Generate a new video directly for a stream in VOD

    Generate a new on-demand video for live recording stream 99873.

    Input Example

    https://vod.intl.tencentcloudapi.com/?Action=EditMedia
&InputType=Stream
&StreamInfos.0.StreamId=99873
&<Common request parameters>

    Output Example

    {
    "Response": {
        "RequestId": "6ca31e3a-6b8e-4b4e-9256-fdc700064ef3",
        "TaskId": "125xxx65-EditMedia-bffb15f07530b57bc1aabb01fac74bca"
    }
}

    Example2 Edit a stream in VOD to generate a new video

    For a live recording stream with ID 99873, edit the clip from 10:00:00 to 11:00:00 on 2018-09-20 to generate a new VOD video.

    Input Example

    https://vod.intl.tencentcloudapi.com/?Action=EditMedia
&InputType=Stream
&StreamInfos.0.StreamId=99873
&StreamInfos.0.StartTime=2018-09-20T10:00:00Z
&StreamInfos.0.EndTime=2018-09-20T11:00:00Z
&<Common request parameters>

    Output Example

    {
    "Response": {
        "RequestId": "6ca31e3a-6b8e-4b4e-9256-fdc700064ef3",
        "TaskId": "125xxx65-clipMedia-bffb15f07530b57bc1aabb01fac74bca"
    }
}

    Example3 Concatenate multiple streams in VOD to generate a new video

    Concatenate the three live recording streams with IDs 99873, 99874, and 99875 to generate a new video on demand.

    Input Example

    https://vod.intl.tencentcloudapi.com/?Action=EditMedia
&InputType=Stream
&StreamInfos.0.StreamId=99873
&StreamInfos.1.StreamId=99874
&StreamInfos.2.StreamId=99875
&<Common request parameters>

    Output Example

    {
    "Response": {
        "RequestId": "6ca31e3a-6b8e-4b4e-9256-fdc700064ef3",
        "TaskId": "125xxx65-clipMedia-bffb15f07530b57bc1aabb01fac74bca"
    }
}

    Example4 Editing a VOD File to Generate a New Video

    Edit the video clip from second 60 to second 120 of 5285485487985271487, and generate a new video on demand.

    Input Example

    https://vod.intl.tencentcloudapi.com/?Action=EditMedia
&InputType=File
&FileInfos.0.FileId=5285485487985271487
&FileInfos.0.StartTimeOffset=60.0
&FileInfos.0.EndTimeOffset=120.0
&<Common request parameters>

    Output Example

    {
    "Response": {
        "RequestId": "6ca31e3a-6b8e-4b4e-9256-fdc700064ef3",
        "TaskId": "125xxx65-EditMedia-bffb15f07530b57bc1aabb01fac74bca"
    }
}

    Example5 Concatenate multiple files in VOD to generate a new video

    Concatenate three videos 5285485487985271487, 5285485487985271488, and 5285485487985271489 to generate a new video on demand.

    Input Example

    https://vod.intl.tencentcloudapi.com/?Action=EditMedia
&InputType=File
&FileInfos.0.FileId=5285485487985271487
&FileInfos.1.FileId=5285485487985271488
&FileInfos.2.FileId=5285485487985271489
&<Common request parameters>

    Output Example

    {
    "Response": {
        "RequestId": "6ca31e3a-6b8e-4b4e-9256-fdc700064ef3",
        "TaskId": "125xxx65-EditMedia-bffb15f07530b57bc1aabb01fac74bca"
    }
}

    Example6 Editing Multiple VOD Streams and Concatenating Them to Generate a New Video

    This example shows you how to edit the live recording streams with IDs 99873, 99874, and 99875 into clips from 10:00:00 to 11:00:00 on September 20, 2018, and stitch them into a new VOD video.

    Input Example

    https://vod.intl.tencentcloudapi.com/?Action=EditMedia
&InputType=Stream
&StreamInfos.0.StreamId=99873
&StreamInfos.0.StartTime=2018-09-20T10:00:00Z
&StreamInfos.0.EndTime=2018-09-20T11:00:00Z
&StreamInfos.1.StreamId=99874
&StreamInfos.1.StartTime=2018-09-20T10:00:00Z
&StreamInfos.1.EndTime=2018-09-20T11:00:00Z
&StreamInfos.2.StreamId=99875
&StreamInfos.2.StartTime=2018-09-20T10:00:00Z
&StreamInfos.2.EndTime=2018-09-20T11:00:00Z
&<Common request parameters>

    Output Example

    {
    "Response": {
        "RequestId": "6ca31e3a-6b8e-4b4e-9256-fdc700064ef3",
        "TaskId": "125xxx65-clipMedia-bffb15f07530b57bc1aabb01fac74bca"
    }
}

    Example7 Editing Multiple VOD Files and Concatenating Them to Generate a New Video

    Edit three videos 5285485487985271487, 5285485487985271488, and 5285485487985271489 (clip the segment from 60s to 120s), then concatenate them to generate a new video on demand.

    Input Example

    https://vod.intl.tencentcloudapi.com/?Action=EditMedia
&InputType=File
&FileInfos.0.FileId=5285485487985271487
&FileInfos.0.StartTimeOffset=60.0
&FileInfos.0.EndTimeOffset=120.0
&FileInfos.1.FileId=5285485487985271488
&FileInfos.1.StartTimeOffset=60.0
&FileInfos.1.EndTimeOffset=120.0
&FileInfos.2.FileId=5285485487985271489
&FileInfos.2.StartTimeOffset=60.0
&FileInfos.2.EndTimeOffset=120.0
&<Common request parameters>

    Output Example

    {
    "Response": {
        "RequestId": "6ca31e3a-6b8e-4b4e-9256-fdc700064ef3",
        "TaskId": "125xxx65-EditMedia-bffb15f07530b57bc1aabb01fac74bca"
    }
}

    Example8 Editing a VOD File to Generate a New Video and Execute Task Flow on the New Video

    Edit the recording clip from second 60 to second 120 of 5285485487985271487, generate a new video on demand, and execute task flow TranscodeAndSnapshot.

    Input Example

    https://vod.intl.tencentcloudapi.com/?Action=EditMedia
&InputType=File
&FileInfos.0.FileId=5285485487985271487
&FileInfos.0.StartTimeOffset=60.0
&FileInfos.0.EndTimeOffset=120.0
&ProcedureName=TranscodeAndSnapshot
&<Common request parameters>

    Output Example

    {
    "Response": {
        "RequestId": "6ca31e3a-6b8e-4b4e-9256-fdc700064ef3",
        "TaskId": "125xxx65-clipMedia-bffb15f07530b57bc1aabb01fac74bca"
    }
}

    5. Developer Resources

    SDK

    TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

    Command Line Interface

    6. Error Code

    The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

    Error Code Description
    FailedOperation Operation failed.
    FailedOperation.InvalidVodUser The VOD service is not enabled.
    InternalError Internal error.
    InvalidParameterValue.SessionContextTooLong SessionContext is too long.
    InvalidParameterValue.SessionId Duplicate recognition code. Request deduplicated.
    InvalidParameterValue.SessionIdTooLong SessionId is too long.
    InvalidParameterValue.SubAppId Parameter value error: app ID.
    ResourceNotFound The resource does not exist.
    UnauthorizedOperation Unauthorized operation.
    上一篇: ProcessMediaByProcedure下一篇: ComposeMedia

    帮助和支持

    本页内容是否解决了您的问题？

    填写满意度调查问卷，共创更好文档体验。

    文档反馈

    搜索
      请输入关键词搜索文档