SubmitAnalysisJob - 提交预置模板分析作业 - 媒体处理

提交预置模板分析作业。

接口说明

通过本接口提交作业以后，媒体处理服务会对输入文件进行智能分析，推荐出适合输入文件的预置模板，可通过查询模板分析作业接口得到模板分析作业结果，也可使用异步通知机制。
预置模板分析的结果只保留半个月（从得到结果时算起），半个月后将被删除。如果半个月后再使用推荐的预置模板提交作业将返回转码作业失败，失败的错误码为：AnalysisResultNotFound。

QPS 限制

本接口的单用户 QPS 限制为 100 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

mts:SubmitAnalysisJob

create

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
Input	string	是	作业输入，JSON 对象。需在 OSS 控制台 Bucket 授权页面将 Bucket 读权限授权给媒体转码服务。更多信息请参见参数详情。说明 OSS 的地域需要与当前 MPS 所在地域保持一致。	{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.flv"}
AnalysisConfig	string	否	模板分析作业配置，根据您的实际需要按需设置。更多参数信息请参见参数详情。	{"QualityControl":{"RateQuality":25,"MethodStreaming":"network"}}
UserData	string	否	用户自定义数据，可以使用中英文、数字、中划线（-）等，不能以特殊字符开头，最大长度 1024 个字节。	testid-001
PipelineId	string	是	管道 ID，可以通过 MPS 控制台>全局设置>管道查看。如果需要异步通知，须保证此管道绑定了可用的消息主题。	bb558c1cc25b45309aab5be44d19****
Priority	string	否	任务在其对应管道内的转码优先级。取值范围：[1,10]，10 为最高优先级。默认值：6。	10

返回参数

名称	类型	描述	示例值
	object	返回参数。
RequestId	string	请求 ID。	B52658D4-07AB-43CD-82B0-210958A65E23
AnalysisJob	object	系统预置模板分析作业。
CreationTime	string	作业添加时间。	2014-01-10T12:00:00Z
Percent	integer	转码进度。	100
State	string	作业状态。 Submitted：已提交。 Analyzing：分析中。 Success：分析成功。 Fail：分析失败。	Success
AnalysisConfig	object	作业配置。
QualityControl	object	输出质量控制。
MethodStreaming	string	播放方式。 network：在线。 local：本地。默认值：network。	network
RateQuality	string	输出质量等级。	50
PropertiesControl	object	属性控制。
Deinterlace	string	强制扫描模式判定。 Auto：自动。 Force：强制做 deinterlace。 None：强制不做 deinterlace。	Force
Crop	object	视频裁切配置。
Top	string	裁切上边距。说明若 Mode 为 Auto 或 None，则此值失效。	8
Width	string	裁切后宽。说明若 Mode 为 Auto 或 None，则此值失效。	8
Height	string	裁切后高。说明若 Mode 为 Auto 或 None，则此值失效。	8
Left	string	裁切左边距。说明若 Mode 为 Auto 或 None，则此值失效。	8
Mode	string	裁切方式。取值： Auto：自动（默认）。 Force：强制。 None：强制不做。	Auto
Message	string	分析失败时错误信息。	The resource operated \"PipelineId\" cannot be found
Priority	string	任务在其对应管道内的优先级。取值范围：[1,10]。10 为最高优先级。默认值：10。	10
MNSMessageResult	object	MNS 通知用户作业完成的结果。
MessageId	string	成功时消息 ID。分析失败时不返回此参数。	3ca84a39a9024f19853b21be9cf9****
ErrorMessage	string	失败时错误信息。分析成功时不返回此参数。	The resource operated \"PipelineId\" cannot be found
ErrorCode	string	失败时错误码。分析成功时不返回此参数。	InvalidParameter.ResourceNotFound
TemplateList	object
Template	array<object>	作业输出的预置模板列表。
	array<object>	作业输出的预置模板详细信息。
Video	object	视频编解码配置。
Bufsize	string	缓冲区大小。单位：Kb。默认值：6000。	5000
Degrain	string	独立去噪算法强度。	5
BitrateBnd	object	视频平均码率范围。
Max	string	总码率上限。单位：Kbps。	20
Min	string	总码率下限。单位：Kbps。	10
PixFmt	string	视频颜色格式。包含 yuv420p，yuvj420p 等标准颜色格式。	yuvj420p
Codec	string	编解码格式。默认值：H.264。	H.264
Height	string	视频高。单位：px。默认值：视频原始高度。	1880
Qscale	string	视频质量控制度。	15
Bitrate	string	视频平均码率。单位：Kbps。	10
Maxrate	string	视频码率峰值。单位：Kbps。	10
Profile	string	编码级别。 baseline：针对移动设备。 main：针对标准分辨率设备。 high：针对高分辨率设备。默认值：high。	baseline
Crf	string	码率-质量控制因子。默认值：编码格式为 H264，默认值为 23。编码格式为 H265，默认值为 26。如果设置了 Crf，则 Bitrate 的设置失效。	27
Gop	string	关键帧间最大帧数。默认值：250。	1
Width	string	视频宽。单位：px。默认值：视频原始宽度。	1990
Fps	string	帧率。当输入文件帧率超过 60 时取 60。默认值：取输入文件帧率。	60
Preset	string	视频算法器预置。支持 veryfast（超快）、fast（快）、medium（中等）、slow（慢）、slower（超慢）。默认值：medium。	medium
ScanMode	string	扫描模式。取值： interlaced：交叉扫描。 progressive：顺序扫描。	progressive
TransConfig	object	转码通用配置。
TransMode	string	转码模式。取值：onepass、twopass、CBR。默认值：onepass。	onepass
State	string	模板的状态。 Normal：正常。 Deleted：已删除。	Normal
MuxConfig	object	转码封包配置。
Gif	object	gif 格式。
FinalDelay	string	gif 的 loop 间隔，单位为百分之一秒，比如 500 代表间隔为 5 秒。	0
Loop	string	gif 与 webp 循环次数，默认不循环。	0
Segment	object	切片配置。
Duration	string	分片时长。单位：秒。	60
Name	string	模板名称。	FLV-UD
Audio	object	音频编解码配置。
Profile	string	音频编码预置。当 Codec 为 aac 时可取值：aac_low、aac_he、aac_he_v2、aac_ld、aac_eld。	aac_low
Codec	string	音频编解码格式。默认值：aac。	mp3
Samplerate	string	采样率。单位：Hz。默认值：44100。	32000
Qscale	string	音频质量控制度。	10
Channels	string	声道数。默认值：2。	1
Bitrate	string	输出文件的音频码率。单位：Kbps。默认值：128。	8
Id	string	转码模板 ID。	S00000000-00****
Container	object	容器。
Format	string	容器格式。	flv
UserData	string	用户自定义数据。	testid-001
Code	string	分析失败时错误码。分析成功时不返回此参数。	InvalidParameter.ResourceNotFound
InputFile	object	作业输入。
Object	string	OSS 的 Object。	example.flv
Location	string	OSS 的服务区域。	oss-cn-hangzhou
Bucket	string	OSS 的 Bucket。	example-bucket
PipelineId	string	管道 ID。	bb558c1cc25b45309aab5be44d19****
Id	string	模板分析作业 ID。	57f6aa3f84824309bcba67231b40****

示例

正常返回示例

JSON格式

{
  "RequestId": "B52658D4-07AB-43CD-82B0-210958A65E23",
  "AnalysisJob": {
    "CreationTime": "2014-01-10T12:00:00Z",
    "Percent": 100,
    "State": "Success",
    "AnalysisConfig": {
      "QualityControl": {
        "MethodStreaming": "network",
        "RateQuality": "50"
      },
      "PropertiesControl": {
        "Deinterlace": "Force",
        "Crop": {
          "Top": "8",
          "Width": "8",
          "Height": "8",
          "Left": "8",
          "Mode": "Auto"
        }
      }
    },
    "Message": "The resource operated \\\"PipelineId\\\" cannot be found",
    "Priority": "10",
    "MNSMessageResult": {
      "MessageId": "3ca84a39a9024f19853b21be9cf9****",
      "ErrorMessage": "The resource operated \\\"PipelineId\\\" cannot be found",
      "ErrorCode": "InvalidParameter.ResourceNotFound"
    },
    "TemplateList": {
      "Template": [
        {
          "Video": {
            "Bufsize": "5000",
            "Degrain": "5",
            "BitrateBnd": {
              "Max": "20",
              "Min": "10"
            },
            "PixFmt": "yuvj420p",
            "Codec": "H.264",
            "Height": "1880",
            "Qscale": "15",
            "Bitrate": "10",
            "Maxrate": "10",
            "Profile": "baseline",
            "Crf": "27",
            "Gop": "1",
            "Width": "1990",
            "Fps": "60",
            "Preset": "medium",
            "ScanMode": "progressive"
          },
          "TransConfig": {
            "TransMode": "onepass"
          },
          "State": "Normal",
          "MuxConfig": {
            "Gif": {
              "FinalDelay": "0",
              "Loop": "0"
            },
            "Segment": {
              "Duration": "60"
            }
          },
          "Name": "FLV-UD",
          "Audio": {
            "Profile": "aac_low",
            "Codec": "mp3",
            "Samplerate": "32000",
            "Qscale": "10",
            "Channels": "1",
            "Bitrate": "8"
          },
          "Id": "S00000000-00****",
          "Container": {
            "Format": "flv"
          }
        }
      ]
    },
    "UserData": "testid-001",
    "Code": "InvalidParameter.ResourceNotFound",
    "InputFile": {
      "Object": "example.flv",
      "Location": "oss-cn-hangzhou",
      "Bucket": "example-bucket"
    },
    "PipelineId": "bb558c1cc25b45309aab5be44d19****",
    "Id": "57f6aa3f84824309bcba67231b40****"
  }
}

错误码

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

变更历史

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