使用SubmitMediaInfoJob提交媒体异步分析任务-智能媒体服务-阿里云-智能媒体服务(IMS)-阿里云帮助中心

提交媒体信息异步任务。

接口说明

该接口为异步接口，提交任务后返回任务 ID（此时任务尚未完成，任务将进入后台排队异步执行），最终结果将通过回调通知，也可通过媒体信息任务查询主动查询任务状态。
可以调用本接口，通过回调或者再次查询的方式，对输入的文件进行媒体分析，适用于时效性需求相对较弱，或并发量高的场景。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ice:SubmitMediaInfoJob

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
Name	string	否	任务名字。	job-name
Input	object	是	任务输入。	job-name
Type	string	是	媒体对象类型 OSS：oss 文件 Media：媒资 ID	OSS
Media	string	是	媒体值： type 为 OSS 时，为 URL, 支持 OSS 协议和 HTTP 协议。说明 URL 中的 OSS bucket 需要先添加到 IMS存储管理后再使用。 type 为 Media 时，为媒资 ID。	oss://bucket/path/to/video.mp4
UserData	string	否	用户数据。	user-data
ScheduleConfig	object	否	调度参数。	user-data
PipelineId	string	否	管道 ID。	e37ebee5d98b4781897f6086e89f9c56
Priority	integer	否	任务优先级。数字越大优先级越高，取值范围：1~10	5

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 id。	31E30781-9495-5E2D-A84D-759B0A01E262
MediaInfoJob	object	MediaInfoJobDTO
Name	string	任务名字。	job-name
TriggerSource	string	任务来源 API：API WorkFlow：工作流 Console：控制台	API
JobId	string	任务 id。	ab4802364a2e49208c99efab82dfa8e8
Input	object	任务输入。
Type	string	媒体对象类型。取值： OSS：OSS 文件 Media：媒资 ID	OSS
Media	string	媒体值： type 为 OSS 时，为 URL, 支持 OSS 协议和 HTTP 协议； type 为 Media 时，为媒资 ID。	oss://bucket/path/to/video.mp4
Async	boolean	是否异步处理。	true
UserData	string	用户数据。	user-data
ScheduleConfig	object	调度信息。
PipelineId	string	管道 ID。	e37ebee5d98b4781897f6086e89f9c56
Priority	integer	任务优先级。数字越大优先级越高，取值范围：1~10	5
Status	string	任务状态 Init：已提交 Success：成功 Fail：失败	Init
SubmitResultJson	object	任务提交信息。	{}
MediaInfoProperty	object	媒体信息详情。
FileBasicInfo	object	基础文件信息。
MediaId	string	媒资 ID。	2b36bd19c13f4145b094c0cad80dbce5
FileName	string	文件名。	file.m3u8
FileStatus	string	文件状态。	Normal
FileType	string	文件类型。	source_file
FileSize	string	文件大小。	31737
FileUrl	string	文件 URL。	http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8
Region	string	文件所在区域。	cn-shanghai
FormatName	string	视频格式名称。	hls,applehttp
Duration	string	视频时长。	403.039999
Bitrate	string	视频码率。	888.563
Width	string	宽。	848
Height	string	高。	478
AudioStreamInfoList	array<object>	音频流信息。
	object	音频流信息。
Index	string	流序号。	1
CodecName	string	编码格式。	aac
CodecLongName	string	编码格式名。	AAC (Advanced Audio Coding)
CodecTimeBase	string	编码器时间基。	1/44100
CodecTagString	string	编码器标签名。	[15][0][0][0]
CodecTag	string	编码器标签。	0x000f
SampleFmt	string	采样格式。	fltp
SampleRate	string	采样率（单位：Hz）。	44100
Channels	string	声道数。	2
ChannelLayout	string	声道布局。	stereo
Timebase	string	时间基。	1/90000
StartTime	string	开始时间。	1.473556
Duration	string	时长（单位：秒）。	403.039989
Bitrate	string	码率。	0.f
Lang	string	语言。	us
VideoStreamInfoList	array<object>	视频流信息。
	object	视频流信息。
Index	string	流序号。	0
Codec_name	string	编码格式。	h264
Codec_long_name	string	编码格式名。	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
Profile	string	编码器预设。	High
Codec_time_base	string	编码时基。	1/50
Codec_tag_string	string	编码格式标记文本。	[27][0][0][0]
Codec_tag	string	编码格式标记。	0x001b
Width	string	宽。	848
Height	string	高。	478
Has_b_frames	string	是否有 B 帧。取值： 0：没有 B 帧, 1：有一个 B 帧, 2：有多个连续 B 帧。	2
Sar	string	采集点数宽高比。	478:477
Dar	string	图像显示宽高比。	16:9
PixFmt	string	颜色存储格式。	yuv420p
Level	string	编码等级。	31
Fps	string	帧率。	25.0
Avg_fps	string	平均帧率。	25.0
Time_base	string	时基。	1/90000
Start_time	string	起始时间。	1.473556
Duration	string	时长。	403.039989
Bit_rate	string	码率。	888.563
NumFrames	string	总帧数。	10040
Lang	string	语言。	zh
Rotate	string	视频画面旋转角度。	0
SubmitTime	string	任务提交时间。	2022-01-12T08:49:41Z
FinishTime	string	任务完成时间。	2022-01-12T08:49:41Z
RequestId	string	请求 id。	4879B9DE-E4B6-19DC-91F5-9D5F4DCE4168

示例

正常返回示例

JSON格式

{
  "RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262",
  "MediaInfoJob": {
    "Name": "job-name",
    "TriggerSource": "API",
    "JobId": "ab4802364a2e49208c99efab82dfa8e8",
    "Input": {
      "Type": "OSS",
      "Media": "oss://bucket/path/to/video.mp4"
    },
    "Async": true,
    "UserData": "user-data",
    "ScheduleConfig": {
      "PipelineId": "e37ebee5d98b4781897f6086e89f9c56",
      "Priority": 5
    },
    "Status": "Init",
    "SubmitResultJson": {},
    "MediaInfoProperty": {
      "FileBasicInfo": {
        "MediaId": "2b36bd19c13f4145b094c0cad80dbce5",
        "FileName": "file.m3u8",
        "FileStatus": "Normal",
        "FileType": "source_file",
        "FileSize": "31737",
        "FileUrl": "http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8",
        "Region": "cn-shanghai",
        "FormatName": "hls,applehttp",
        "Duration": "403.039999",
        "Bitrate": "888.563",
        "Width": "848",
        "Height": "478"
      },
      "AudioStreamInfoList": [
        {
          "Index": "1",
          "CodecName": "aac",
          "CodecLongName": "AAC (Advanced Audio Coding)",
          "CodecTimeBase": "1/44100",
          "CodecTagString": "[15][0][0][0]",
          "CodecTag": "0x000f",
          "SampleFmt": "fltp",
          "SampleRate": "44100",
          "Channels": "2",
          "ChannelLayout": "stereo",
          "Timebase": "1/90000",
          "StartTime": "1.473556",
          "Duration": "403.039989",
          "Bitrate": "0.f",
          "Lang": "us"
        }
      ],
      "VideoStreamInfoList": [
        {
          "Index": "0",
          "Codec_name": "h264",
          "Codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
          "Profile": "High",
          "Codec_time_base": "1/50",
          "Codec_tag_string": "[27][0][0][0]",
          "Codec_tag": "0x001b",
          "Width": "848",
          "Height": "478",
          "Has_b_frames": "2",
          "Sar": "478:477",
          "Dar": "16:9",
          "PixFmt": "yuv420p",
          "Level": "31",
          "Fps": "25.0",
          "Avg_fps": "25.0",
          "Time_base": "1/90000",
          "Start_time": "1.473556",
          "Duration": "403.039989",
          "Bit_rate": "888.563",
          "NumFrames": "10040",
          "Lang": "zh",
          "Rotate": "0"
        }
      ]
    },
    "SubmitTime": "2022-01-12T08:49:41Z",
    "FinishTime": "2022-01-12T08:49:41Z",
    "RequestId": "4879B9DE-E4B6-19DC-91F5-9D5F4DCE4168"
  }
}

错误码

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

变更历史

更多信息，参考变更详情。