创建云端转码任务。
接口说明
服务接入点
本接口可用的服务接入点包括：
| 地域名称 | 地域 ID | 公网接入地址 |
| 新加坡 | ap-southeast-1 | live.ap-southeast-1.aliyuncs.com |
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| AppId |
string |
是 |
频道所属的应用 ID。由大小写字母、数字、下划线、短划线（-）组成，最大 64 字符。 |
********-7074-****-9ef5-85c19a4***** |
| ChannelId |
string |
是 |
待转码用户所属的频道 ID。由大小写字母、数字、下划线、短划线（-）组成，最大 64 字符。 |
myChannel |
| InputParam |
object |
是 |
订阅输入相关参数。 |
|
| SingleSubUserParam |
object |
是 |
单流订阅输入参数。 |
|
| UserId |
string |
是 |
订阅的用户 ID。 |
userA |
| StreamType |
integer |
否 |
订阅用户的媒体类型。取值：
|
0 |
| SourceType |
integer |
否 |
订阅的视频输入流类型，仅订阅媒体类型包含视频流有效。取值：
|
0 |
| OutputParams |
array<object> |
是 |
转码输出相关参数。 |
|
|
object |
否 |
转码输出参数。 |
||
| ChannelId |
string |
是 |
转码流转推到的频道 ID。由大小写字母、数字、下划线、短划线（-）组成，最大 64 字符。（暂不支持转推到不同的频道，设置无效） |
myChannel |
| UserId |
string |
是 |
转码流转推到频道的用户 ID，需保证与频道内其它用户 ID 不同。 |
userA_360p |
| UserToken |
string |
是 |
转码流转推到频道所需的用户 Token，详见 Token 鉴权。 |
eyJhcHBpZCI******** |
| TranscodeTemplate |
string |
是 |
转码模板名。取值：
|
lhd |
| MaxIdleTime |
integer |
否 |
空闲超时时间，当任务处于空闲状态（订阅不到指定主播流）的时长超过一定时间会自动停止。 单位为秒，范围须在[10,14400]内，即最大 4 小时，默认为 300 秒。 |
600 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回内容。 |
||
| RequestId |
string |
请求 ID。 |
******3B-0E1A-586A-AC29-742247****** |
| TaskId |
string |
云端转码任务 ID。 |
******73-8501-****-8ac1-72295a****** |
示例
正常返回示例
JSON格式
{
"RequestId": "******3B-0E1A-586A-AC29-742247******",
"TaskId": "******73-8501-****-8ac1-72295a******"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidParameter%s | %s. | |
| 400 | MissingParameter%s | %s. | |
| 400 | TooManyRequests | %s. | |
| 500 | InternalError | %s. | 直播 liveapi 服务端错误。 |
| 403 | Forbidden | %s. | |
| 404 | NotFound%s | %s. |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。