Domain name for API request: mps.intl.tencentcloudapi.com.
This API is used to initiate processing tasks on a live stream. Features include:
Intelligent content moderation (porn detection in images, sensitive information detection, audio pornography detection);
Live stream processing event notification supports HTTP callbacks and also supports real-time writing to the message queue CMQ specified by the user. The user obtains the event notification result from the message queue CMQ. Meanwhile, if an output file exists during the process, it will be written to the target storage of the output file specified by the user.
A maximum of 100 requests can be initiated per second for this API.
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: ProcessLiveStream. |
| Version | Yes | String | Common Params. The value used for this API: 2019-06-12. |
| Region | No | String | Common Params. This parameter is not required for this API. |
| Url | Yes | String | Live stream URL (must be a live streaming address, supporting rtmp, hls, flv, trtc, webrtc, srt, etc.). webrtc supports LEB live streams. For address retrieval, please refer For srt supported addresses, please refer |
| TaskNotifyConfig | Yes | LiveStreamTaskNotifyConfig | |
| OutputStorage | No | TaskOutputStorage | |
| OutputDir | No | String | |
| AiContentReviewTask | No | AiContentReviewTaskInput | |
| AiRecognitionTask | No | AiRecognitionTaskInput | |
| AiAnalysisTask | No | AiAnalysisTaskInput | |
| AiQualityControlTask | No | AiQualityControlTaskInput | |
| SmartSubtitlesTask | No | LiveSmartSubtitlesTaskInput | |
| SessionId | No | String | |
| SessionContext | No | String | |
| ScheduleId | No | Integer | |
| ResourceId | No | String |
| Parameter Name | Type | Description |
|---|---|---|
| TaskId | String | |
| 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. |
This example shows you how to initiate a content recognition task for a live stream with the URL http://www.abc.com/abc.m3u8.
POST / HTTP/1.1
Host: mps.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ProcessLiveStream
<Common request parameters>
{
"Url": "http://www.abc.com/abc.m3u8",
"AiRecognitionTask": {
"Definition": 10
},
"TaskNotifyConfig": {
"CmqRegion": "gz",
"CmqModel": "Queue",
"QueueName": "queue-125717729292"
}
}{
"Response": {
"RequestId": "5ca61e3a-6b8e-4b4e-9256-fdc701190064ef0",
"TaskId": "125xxxxxx07-live-procedure-813dc41e6fdc22dcf24aa6e9c61cp92"
}
}TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
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.GenerateResource | Resource generation failed. |
| FailedOperation.InvalidMpsUser | Operation failed: illegal mps user. |
| InternalError | Internal error. |
| InvalidParameter | Parameter error. |
| InvalidParameterValue.Definition | Parameter error: Definition. |
| InvalidParameterValue.Definitions | Parameter error: Definitions. |
| InvalidParameterValue.SessionId |
文档反馈