SubmitAnalysisJob - 提交预置模板分析作业

提交预置模板分析作业。

接口说明

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

QPS 限制

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

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
mts:SubmitAnalysisJob
  • 全部资源
    *

请求参数

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

作业输入,JSON 对象。需在 OSS 控制台 Bucket 授权页面将 Bucket 读权限授权给媒体转码服务。更多信息请参见参数详情

说明 OSS 的地域需要与当前 MPS 所在地域保持一致。
{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.flv"}
AnalysisConfigstring

模板分析作业配置,根据您的实际需要按需设置。更多参数信息请参见参数详情

{"QualityControl":{"RateQuality":25,"MethodStreaming":"network"}}
UserDatastring

用户自定义数据,可以使用中英文、数字、中划线(-)等,不能以特殊字符开头,最大长度 1024 个字节。

testid-001
PipelineIdstring

管道 ID,可以通过 MPS 控制台>全局设置>管道查看。如果需要异步通知,须保证此管道绑定了可用的消息主题。

bb558c1cc25b45309aab5be44d19****
Prioritystring

任务在其对应管道内的转码优先级。

  • 取值范围:[1,10],10 为最高优先级。
  • 默认值:6
10

返回参数

名称类型描述示例值
object

返回参数。

RequestIdstring

请求 ID。

B52658D4-07AB-43CD-82B0-210958A65E23
AnalysisJobobject

系统预置模板分析作业。

CreationTimestring

作业添加时间。

2014-01-10T12:00:00Z
Percentlong

转码进度。

100
Statestring

作业状态。

  • Submitted:已提交。

  • Analyzing:分析中。

  • Success:分析成功。

  • Fail:分析失败。

Success
AnalysisConfigobject

作业配置。

QualityControlobject

输出质量控制。

MethodStreamingstring

播放方式。

  • network:在线。

  • local:本地。

  • 默认值:network

network
RateQualitystring

输出质量等级。

50
PropertiesControlobject

属性控制。

Deinterlacestring

强制扫描模式判定。

  • Auto:自动。
  • Force:强制做 deinterlace。
  • None:强制不做 deinterlace。
Force
Cropobject

视频裁切配置。

Topstring

裁切上边距。

说明 Mode 为 Auto 或 None,则此值失效。
8
Widthstring

裁切后宽。

说明 Mode 为 Auto 或 None,则此值失效。
8
Heightstring

裁切后高。

说明 Mode 为 Auto 或 None,则此值失效。
8
Leftstring

裁切左边距。

说明 Mode 为 Auto 或 None,则此值失效。
8
Modestring

裁切方式。取值:

  • Auto:自动(默认)。
  • Force:强制。
  • None:强制不做。
Auto
Messagestring

分析失败时错误信息。

The resource operated \"PipelineId\" cannot be found
Prioritystring

任务在其对应管道内的优先级。

  • 取值范围:[1,10]。10 为最高优先级。

  • 默认值:10

10
MNSMessageResultobject

MNS 通知用户作业完成的结果。

MessageIdstring

成功时消息 ID。分析失败时不返回此参数。

3ca84a39a9024f19853b21be9cf9****
ErrorMessagestring

失败时错误信息。分析成功时不返回此参数。

The resource operated \"PipelineId\" cannot be found
ErrorCodestring

失败时错误码。分析成功时不返回此参数。

InvalidParameter.ResourceNotFound
TemplateListarray<object>

作业输出的预置模板列表。

Templateobject

作业输出的预置模板详细信息。

Videoobject

视频编解码配置。

Bufsizestring

缓冲区大小。

  • 单位:Kb。
  • 默认值:6000
5000
Degrainstring

独立去噪算法强度。

5
BitrateBndobject

视频平均码率范围。

Maxstring

总码率上限。单位:Kbps。

20
Minstring

总码率下限。单位:Kbps。

10
PixFmtstring

视频颜色格式。包含 yuv420p,yuvj420p 等标准颜色格式。

yuvj420p
Codecstring

编解码格式。默认值:H.264

H.264
Heightstring

视频高。

  • 单位:px。
  • 默认值:视频原始高度
1880
Qscalestring

视频质量控制度。

15
Bitratestring

视频平均码率。单位:Kbps。

10
Maxratestring

视频码率峰值。单位:Kbps。

10
Profilestring

编码级别。

  • baseline:针对移动设备。

  • main:针对标准分辨率设备。

  • high:针对高分辨率设备。

  • 默认值:high

baseline
Crfstring

码率-质量控制因子。

  • 默认值:编码格式为 H264,默认值为 23。编码格式为 H265,默认值为 26

  • 如果设置了 Crf,则 Bitrate 的设置失效。

27
Gopstring

关键帧间最大帧数。默认值:250

1
Widthstring

视频宽。

  • 单位:px。
  • 默认值:视频原始宽度
1990
Fpsstring

帧率。

  • 当输入文件帧率超过 60 时取 60。
  • 默认值:取输入文件帧率
60
Presetstring

视频算法器预置。支持 veryfast(超快)、fast(快)、medium(中等)、slow(慢)、slower(超慢)。默认值:medium

medium
ScanModestring

扫描模式。取值:

  • interlaced:交叉扫描。

  • progressive:顺序扫描。

progressive
TransConfigobject

转码通用配置。

TransModestring

转码模式。取值:onepass、twopass、CBR。默认值:onepass

onepass
Statestring

模板的状态。

  • Normal:正常。

  • Deleted:已删除。

Normal
MuxConfigobject

转码封包配置。

Gifobject

gif 格式。

FinalDelaystring

gif 的 loop 间隔,单位为百分之一秒,比如 500 代表间隔为 5 秒。

0
Loopstring

gif 与 webp 循环次数,默认不循环。

0
Segmentobject

切片配置。

Durationstring

分片时长。单位:秒。

60
Namestring

模板名称。

FLV-UD
Audioobject

音频编解码配置。

Profilestring

音频编码预置。当 Codecaac 时可取值:aac_low、aac_he、aac_he_v2、aac_ld、aac_eld。

aac_low
Codecstring

音频编解码格式。默认值:aac

mp3
Sampleratestring

采样率。

  • 单位:Hz。
  • 默认值:44100
32000
Qscalestring

音频质量控制度。

10
Channelsstring

声道数。默认值:2

1
Bitratestring

输出文件的音频码率。

  • 单位:Kbps。
  • 默认值:128
8
Idstring

转码模板 ID。

S00000000-00****
Containerobject

容器。

Formatstring

容器格式。

flv
UserDatastring

用户自定义数据。

testid-001
Codestring

分析失败时错误码。分析成功时不返回此参数。

InvalidParameter.ResourceNotFound
InputFileobject

作业输入。

Objectstring

OSS 的 Object。

example.flv
Locationstring

OSS 的服务区域。

oss-cn-hangzhou
Bucketstring

OSS 的 Bucket。

example-bucket
PipelineIdstring

管道 ID。

bb558c1cc25b45309aab5be44d19****
Idstring

模板分析作业 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****"
  }
}

错误码

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

变更历史

变更时间变更内容概要操作
暂无变更历史