调用SubmitAnalysisJob提交预置模板分析作业。媒体处理服务会对输入文件进行智能分析,推荐出适合输入文件的预置模板;可通过查询模板分析作业接口得到模板分析作业结果,也可使用异步通知机制。

说明 预置模板分析的结果只保留半个月,半个月后将被删除,若半个月后再使用推荐的预置模板提交作业将返回转码作业失败,失败的错误码为:AnalysisResultNotFound

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String SubmitAnalysisJob

操作接口名,系统规定参数,取值:SubmitAnalysisJob

Input String {"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.flv"}

输入,Json对象,需在控制台中资源控制频道里的Bucket授权页面授予此Bucket读权限给媒体转码服务。

PipelineId String 88c6ca184c0e4*****5b665e2a126797

管道ID。

若需要异步通知,须保证此管道绑定了可用的消息主题。

AnalysisConfig String {"QualityControl": {"RateQuality": 25,"MethodStreaming": "network"}}

模板分析作业配置。

UserData String testid-001

用户自定义数据。最大长度1024个字节。

Priority String 10

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

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

返回数据

名称 类型 示例值 描述
AnalysisJob Struct

系统预置模板分析作业。

AnalysisConfig Struct

作业配置。

PropertiesControl Struct

属性控制,JSON对象。

Crop Struct

视频裁切配置。

Height String 8

裁切后高。范围:[8,4096]

说明MODE为Auto、None,此值失效。
Left String 8

裁切左边距。范围:[8,4096]

说明 若MODE为Auto、None,此值失效。
Mode String Auto

取值:

  • Auto:自动(默认),
  • Force:强制,
  • None:强制不做,
说明Crop不是空JOSN{},则此值必填。
Top String 8

裁切上边距。范围:[8,4096]

说明MODE为Auto、None,此值失效。
Width String 8

裁切后宽。范围:[8,4096]

说明MODE为Auto、None,此值失效。
Deinterlace String Force

强制扫描模式判定。

  • Auto:自动
  • Force:强制做deinterlace
  • None:强制不做
QualityControl Struct

输出质量控制,JSON对象。

MethodStreaming String network

播放方式,network或local。默认值:network。

RateQuality String 50

输出质量等级。

取值范围:0~51,值为整数,默认值:25

Code String xxx

分析失败时错误码。

CreationTime String 2014-01-10T12:00:00Z

作业添加时间。

Id String 88c6ca184c0e4*****5b665e2a126797

模板分析作业ID。

InputFile Struct

作业输入。

Bucket String example-bucket

OSS的Bucket。3~63字节。

Location String oss-cn-hangzhou

OSS的服务区域。最大64字节。

Object String example.flv

OSS的Object。最大1024字节。

MNSMessageResult Struct

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

ErrorCode String xxx

失败时错误码。

ErrorMessage String xxx

失败时错误信息。

MessageId String 123

成功时消息ID。

Message String xxx

分析失败时错误信息。

Percent Long 100

转码进度。取值范围:[0,100]

PipelineId String 88c6ca184c0e4*****5b665e2a126797

管道ID。

Priority String 10

任务在其对应管道内的优先级。取值范围:[1, 10],最高优先级:10,默认值:10。

State String Success

作业状态。取值为Submitted、Analyzing、Success、Fail。

TemplateList Array of Template

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

Template
Audio Struct

音频编解码配置。

Bitrate String 8

输出文件的音频码率。

  • 取值范围:8~1000
  • 单位:Kbps
  • 默认值:128
Channels String 1

声道数。

  • 支持1、2、3、4、5、6、7、8
  • 默认值:2
Codec String mp3

音频编解码格式。

  • 支持aac、mp3、vorbis、flac
  • 默认值:aac
Profile String aac_low

音频编码预置。当Codecaac时可以设置如下范围中的值:aac_low、aac_he、aac_he_v2、aac_ld、aac_eld。

Qscale String 10

音频质量控制度。取值范围:1~31

Samplerate String 32000

采样率。

  • 支持22050、32000、44100、48000、96000,
  • 单位:Hz
  • 默认值:44100
Container Struct

容器。

Format String flv

容器格式。

可选范围flv、mp4、ts、m3u8、gif、mp3、ogg、flac。

Id String S00000000-000020

转码模板ID。

MuxConfig Struct

转码封包配置。

Gif Struct

gif格式。

FinalDelay String 0

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

Loop String 0

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

Segment Struct

切片配置。

Duration String 60

分片时长。

  • 取值范围:[1,60]
  • 单位:秒
Name String FLV-UD

模板名称。

State String Normal

模板的状态,取值为Normal、Deleted。

TransConfig Struct

转码通用配置。

TransMode String onepass

转码模式。

  • 可选范围onepass、twopass、CBR
  • 默认值:onepass
Video Struct

视频编解码配置。

Bitrate String 10

视频平均码率。

  • 取值范围:[10,50000]
  • 单位:Kbps
BitrateBnd Struct

视频平均码率范围。

Max String 20

总码率上限。

  • 取值范围:[10,50000]
  • 单位:Kbps
Min String 10

总码率下限。

  • 取值范围:[10,50000]
  • 单位:Kbps
Bufsize String 5000

缓冲区大小。

  • 取值范围:[1000,128000]
  • 单位:Kb
  • 默认值:6000
Codec String H.264

编解码格式。

  • 支持H.264、H.265
  • 默认值:H.264
Crf String 27

码率-质量控制因子。

  • 取值范围:[0,51],默认值:26
  • 如果设置了Crf,则Bitrate的设置失效。
Degrain String 5

独立去噪算法强度。取值范围:[1,9]

Fps String 60

帧率。

  • 取值范围:(0,60]
  • 当输入文件帧率超过60时取60
  • 默认值:取输入文件帧率
Gop String 1

关键帧间最大帧数。

  • 取值范围:[1,1080000]
  • 默认值:250
Height String 1880

高。

  • 取值范围:[128,4096]
  • 单位:px
  • 默认值:视频原始高度
Maxrate String 10

视频码率峰值。

  • 取值范围:[10,50000]
  • 单位:Kbps
PixFmt String yuvj420p

视频颜色格式。

范围:yuv420p,yuvj420p等标准颜色格式。

Preset String medium

视频算法器预置。

  • 支持veryfast、fast、medium、slow、slower
  • 默认值:medium
Profile String baseline

编码级别。取值:

  • baseline:针对移动设备
  • main:针对标准分辨率设备
  • high:针对高分辨率设备,默认值:high
Qscale String 15

视频质量控制度。取值范围:[1,31]

ScanMode String progressive

扫描模式。支持interlaced、progressive。

Width String 1990

宽。

  • 取值范围:[128,4096]
  • 单位:px
  • 默认值:视频原始宽度
UserData String testid-001

用户自定义数据。

RequestId String 25818875-5F78-4A*****F6-D7393642CA58

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=SubmitAnalysisJob
&Input={"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.flv"}
&PipelineId=88c6ca184c0e4*****5b665e2a126797
&<公共请求参数>

正常返回示例

XML格式

<RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
<AnalysisJob>
    <Message>xxx</Message>
    <Percent>100</Percent>
    <UserData>testid-001</UserData>
    <Priority>10</Priority>
    <State>Success</State>
    <CreationTime>2014-01-10T12:00:00Z</CreationTime>
    <PipelineId>88c6ca184c0e4*****5b665e2a126797</PipelineId>
    <Id>88c6ca184c0e4*****5b665e2a126797</Id>
    <Code>xxx</Code>
    <TemplateList>
        <Template>
            <State>Normal</State>
            <Id>S00000000-000020</Id>
            <Name>FLV-UD</Name>
            <Container>
                <Format>flv</Format>
            </Container>
            <Video>
                <Bufsize>5000</Bufsize>
                <Qscale>15</Qscale>
                <ScanMode>progressive</ScanMode>
                <Preset>medium</Preset>
                <Fps>60</Fps>
                <Gop>1</Gop>
                <PixFmt>yuvj420p</PixFmt>
                <Bitrate>10</Bitrate>
                <Profile>baseline</Profile>
                <Maxrate>10</Maxrate>
                <Codec>H.264</Codec>
                <Crf>27</Crf>
                <Height>1880</Height>
                <Degrain>5</Degrain>
                <Width>1990</Width>
                <BitrateBnd>
                    <Min>10</Min>
                    <Max>20</Max>
                </BitrateBnd>
            </Video>
            <Audio>
                <Qscale>10</Qscale>
                <Codec>mp3</Codec>
                <Bitrate>8</Bitrate>
                <Samplerate>32000</Samplerate>
                <Channels>1</Channels>
                <Profile>aac_low</Profile>
            </Audio>
            <TransConfig>
                <TransMode>onepass</TransMode>
            </TransConfig>
            <MuxConfig>
                <Segment>
                    <Duration>60</Duration>
                </Segment>
                <Gif>
                    <FinalDelay>0</FinalDelay>
                    <Loop>0</Loop>
                </Gif>
            </MuxConfig>
        </Template>
    </TemplateList>
    <InputFile>
        <Bucket>example-bucket</Bucket>
        <Object>example.flv</Object>
        <Location>oss-cn-hangzhou</Location>
    </InputFile>
    <AnalysisConfig>
        <QualityControl>
            <MethodStreaming>network</MethodStreaming>
            <RateQuality>50</RateQuality>
        </QualityControl>
        <PropertiesControl>
            <Deinterlace>Force</Deinterlace>
            <Crop>
                <Left>8</Left>
                <Top>8</Top>
                <Mode>Auto</Mode>
                <Height>8</Height>
                <Width>8</Width>
            </Crop>
        </PropertiesControl>
    </AnalysisConfig>
    <MNSMessageResult>
        <ErrorCode>xxx</ErrorCode>
        <ErrorMessage>xxx</ErrorMessage>
        <MessageId>123</MessageId>
    </MNSMessageResult>
</AnalysisJob>

JSON格式

{
    "RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
    "AnalysisJob": {
        "Message": "xxx",
        "Percent": 100,
        "UserData": "testid-001",
        "Priority": 10,
        "State": "Success",
        "CreationTime": "2014-01-10T12:00:00Z",
        "PipelineId": "88c6ca184c0e4*****5b665e2a126797",
        "Id": "88c6ca184c0e4*****5b665e2a126797",
        "Code": "xxx",
        "TemplateList": {
            "Template": {
                "State": "Normal",
                "Id": "S00000000-000020",
                "Name": "FLV-UD",
                "Container": {
                    "Format": "flv"
                },
                "Video": {
                    "Bufsize": 5000,
                    "Qscale": 15,
                    "ScanMode": "progressive",
                    "Preset": "medium",
                    "Fps": 60,
                    "Gop": 1,
                    "PixFmt": "yuvj420p",
                    "Bitrate": 10,
                    "Profile": "baseline",
                    "Maxrate": 10,
                    "Codec": "H.264",
                    "Crf": 27,
                    "Height": 1880,
                    "Degrain": 5,
                    "Width": 1990,
                    "BitrateBnd": {
                        "Min": 10,
                        "Max": 20
                    }
                },
                "Audio": {
                    "Qscale": 10,
                    "Codec": "mp3",
                    "Bitrate": 8,
                    "Samplerate": 32000,
                    "Channels": 1,
                    "Profile": "aac_low"
                },
                "TransConfig": {
                    "TransMode": "onepass"
                },
                "MuxConfig": {
                    "Segment": {
                        "Duration": 60
                    },
                    "Gif": {
                        "FinalDelay": 0,
                        "Loop": 0
                    }
                }
            }
        },
        "InputFile": {
            "Bucket": "example-bucket",
            "Object": "example.flv",
            "Location": "oss-cn-hangzhou"
        },
        "AnalysisConfig": {
            "QualityControl": {
                "MethodStreaming": "network",
                "RateQuality": 50
            },
            "PropertiesControl": {
                "Deinterlace": "Force",
                "Crop": {
                    "Left": 8,
                    "Top": 8,
                    "Mode": "Auto",
                    "Height": 8,
                    "Width": 8
                }
            }
        },
        "MNSMessageResult": {
            "ErrorCode": "xxx",
            "ErrorMessage": "xxx",
            "MessageId": 123
        }
    }
}

错误码

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