GetMediaProducingJob - 查询剪辑合成作业

获取剪辑合成作业的详细信息,包括剪辑合成任务的任务状态、时间线、模板及数据等。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
JobIdstring

剪辑合成作业Id

****cdb3e74639973036bc84****

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求ID

****83B7-7F87-4792-BFE9-63CD2137****
MediaProducingJobobject

云剪辑工程信息

JobIdstring

剪辑合成作业Id

****cdb3e74639973036bc84****
ProjectIdstring

云剪辑工程Id

****fddd7748b58bf1d47e95****
MediaIdstring

输出成品的资源Id

****0cc6ba49eab379332c5b****
MediaURLstring

输出成品的资源文件URL

http://example-bucket.oss-cn-shanghai.aliyuncs.com/example2.mp4
Timelinestring

剪辑合成作业对应的时间线

{"VideoTracks":[{"VideoTrackClips":[{"MediaId":"****4d7cf14dc7b83b0e801c****"},{"MediaId":"****4d7cf14dc7b83b0e801c****"}]}]}
TemplateIdstring

剪辑合成作业对应的模板Id

****6e76134d739cc3e85d3e****
ClipsParamstring

剪辑合成作业对应的模板参数

{"VideoArray":["****05512043f49f697f7425****","****05512043f49f697f7425****","****05512043f49f697f7425****"]}
Durationnumber

输出成品的时长

注:当合成任务成功且输出成品的类型为音视频时,该字段有值。

30.500000
CreateTimestring

剪辑合成作业创建时间,格式为utc时间。

格式为:"YYYY-MM-DD'T'hh:mm:ss'Z'"。

2020-12-23T13:33:40Z
CompleteTimestring

剪辑合成作业完成时间,格式为utc时间。

格式为:"YYYY-MM-DD'T'hh:mm:ss'Z'"。

2020-12-23T13:33:52Z
ModifiedTimestring

剪辑合成作业修改时间,格式为utc时间。

格式为:"YYYY-MM-DD'T'hh:mm:ss'Z'"。

2020-12-23T13:33:49Z
Statusstring

剪辑合成作业状态,取值可能为如下值:

-Init (初始状态)

-Queuing(排队中)

-Processing(处理中)

-Success(成功)

-Failed(失败)

Failed
Codestring

剪辑合成作业错误码

注:作业失败时关注该字段

ExceededMaximumValue
Messagestring

剪辑合成作业错误信息

注:作业失败时关注该字段

The specified "Width_Height" has exceeded maximum value.
VodMediaIdstring

如果剪辑任务的成片输出到VOD,成片会注册成一个VOD的媒资,vodMediaId 即该媒资在VOD的媒资ID

****332c5b0cc6ba49eab379****

示例

正常返回示例

JSON格式

{
  "RequestId": "****83B7-7F87-4792-BFE9-63CD2137****",
  "MediaProducingJob": {
    "JobId": "****cdb3e74639973036bc84****",
    "ProjectId": "****fddd7748b58bf1d47e95****",
    "MediaId": "****0cc6ba49eab379332c5b****",
    "MediaURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example2.mp4",
    "Timeline": "{\"VideoTracks\":[{\"VideoTrackClips\":[{\"MediaId\":\"****4d7cf14dc7b83b0e801c****\"},{\"MediaId\":\"****4d7cf14dc7b83b0e801c****\"}]}]}",
    "TemplateId": "****6e76134d739cc3e85d3e****",
    "ClipsParam": "{\"VideoArray\":[\"****05512043f49f697f7425****\",\"****05512043f49f697f7425****\",\"****05512043f49f697f7425****\"]}",
    "Duration": 30.5,
    "CreateTime": "2020-12-23T13:33:40Z",
    "CompleteTime": "2020-12-23T13:33:52Z",
    "ModifiedTime": "2020-12-23T13:33:49Z",
    "Status": "Failed",
    "Code": "ExceededMaximumValue",
    "Message": "The specified \"Width_Height\" has exceeded maximum value.",
    "VodMediaId": "****332c5b0cc6ba49eab379****"
  }
}

错误码

Http code错误码错误信息
400InvalidParameterThe specified parameter \ is not valid.
404JobNotFoundThe specified job not found

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2021-11-25OpenAPI 错误码发生变更、 OpenAPI 返回结构发生变更
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
    删除错误码:404
出参OpenAPI 返回结构发生变更
阿里云首页 智能媒体生产 相关技术圈