1. API Description

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

Live clipping means that during a live broadcast (before it ends), you can select a segment of previous live broadcast content to generate a new video (in HLS format) in real time and share it immediately or store it persistently.

VOD supports two live clipping modes:

• Persistent clipping: in this mode, the clipped video is saved as an independent video file with a FileId, which is suitable for persistently storing highlights;
• Temporary clipping: in this mode, the clipped video is part of the LVB recording file with no FileId, which is suitable for temporarily sharing highlights;

Note:

• The live clipping feature can be used only when time shifting has been enabled for the target live stream.
• Live clipping is performed based on the m3u8 file generated by LVB recording, so its minimum clipping granularity is one ts segment rather than at or below the second level.

Persistent clipping

In persistent clipping mode, the clipped video is saved as an independent video file with a FileId, and its lifecycle is not subject to the source LVB recording video (even if the source video is deleted, the clipped video will not be affected in any way). It can be further processed (transcoded, published on WeChat, etc.).

An example is as follows: for a complete football match, the source LVB recording video may be up to 2 hours in length. You want to store this video for only 2 months for the purpose of cost savings. However, you want to specify a longer retention period for the "highlights" video created by live clipping and perform additional VOD operations on it such as transcoding and release on WeChat. In this case, you need to choose the persistent clipping mode of live clipping.

The advantage of persistent clipping is that the clipped video has a lifecycle independent of the source recording video and can be managed independently and stored persistently.

Temporary clipping

In temporary clipping mode, the clipped video (m3u8 file) shares the same ts segments with the LVB recording video instead of being an independent video. It only has a playback URL but has no FileId, and its validity period is the same as that of the LVB recording video; therefore, if the LVB recording video is deleted, it cannot be played back.

For temporary clipping, as the clipping result is not an independent video, it will not be included in VOD's media asset management (for example, it will not be counted in the total videos in the console), and no video processing operations can be separately performed on it, such as transcoding and release on WeChat.

The advantage of temporary clipping is that the clipping operation is very "lightweight" and does not incur additional storage fees. However, the clipped video has the same lifecycle as the source recording video and cannot be further transcoded or processed.

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

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.

3. Output Parameters

4. Example

Example1 Clipping a live video for temporary sharing

This example shows you how to clip a live stream whose live stream code is record-stream and domain is example.com for temporary sharing, starting at 2018-09-20T10:00:00Z and ending at 2018-09-20T11:00:00Z. Assuming that the live stream has been interrupted for 10 minutes from 2018-09-20T10:30:00Z to 2018-09-20T10:40:00Z, then the output parameter SegmentSet contains the information of two segments and the actual length of the video clip is 50 minutes.

Input Example

https://vod.tencentcloudapi.com/?Action=LiveRealTimeClip
&StreamId=record-stream
&StartTime=2018-09-20T10:00:00Z
&EndTime=2018-09-20T11:00:00Z
&<Common request parameters>

Output Example

{
"Response": {
  "Url": "http://video.com/playlist.m3u8",
  "FileId": "",
  "VodTaskId": "",
  "MetaData": null
}
}

Example2 Clipping a live video for long-term storage

This example shows you how to clip a live stream whose live stream code is record-stream and domain is example.com for long-term storage, starting at 2018-09-20T12:00:00Z and ending at 2018-09-20T13:00:00Z, and initiate a processing task flow.

Input Example

https://vod.tencentcloudapi.com/?Action=LiveRealTimeClip
&StreamId=record-stream
&StartTime=2018-09-20T10:00:00Z
&EndTime=2018-09-20T11:00:00Z
&IsPersistence=1
&Procedure=SomeProcedure
&<Common request parameters>

Output Example

{
"Response": {
  "Url": "http://video.com/playlist.m3u8",
  "FileId": "",
  "VodTaskId": "",
  "MetaData": null,
  "RequestId": "requestId"
}
}

5. Developer Resources

SDK

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

• Tencent Cloud SDK 3.0 for Python
• Tencent Cloud SDK 3.0 for Java
• Tencent Cloud SDK 3.0 for PHP
• Tencent Cloud SDK 3.0 for Go
• Tencent Cloud SDK 3.0 for NodeJS
• Tencent Cloud SDK 3.0 for .NET
• Tencent Cloud SDK 3.0 for C++

Command Line Interface

• Tencent Cloud CLI 3.0

6. Error Code

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