调用QueryAnalysisJobList查询模板分析作业,模板分析作业完成后,返回可用的预置模板列表。

调试

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

请求参数

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

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

AnalysisJobIds String 88c6ca184c0e*****a5b665e2a126797

模板分析作业ID列表。

  • 一次最多查询10个。
  • 多个使用逗号“,”作为分隔符。

返回数据

名称 类型 示例值 描述
AnalysisJobList Array of AnalysisJob

模板分析作业列表。

AnalysisJob
AnalysisConfig Struct

作业配置。

PropertiesControl Struct

属性控制。

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 Auto

强制扫描模式判定。

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

输出质量控制。

MethodStreaming String network

播放方式,network或local。

默认值:network

RateQuality String 25

输出质量等级。

  • 值范围:(0,51] - 值为整数 - 默认值:25 )
Code String xxx

分析失败时错误码。

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

作业添加时间。

Id String 88c6ca184c0e*****a5b665e2a126797

模板分析作业ID。

InputFile Struct

作业输入。

Bucket String example-bucket

OSS Bucket。

Location String oss-cn-hangzhou

OSS Location。

Object String example.flv

OSS Object。

MNSMessageResult Struct

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

ErrorCode String xxx

失败时错误码。

ErrorMessage String xxx

失败时错误信息。

MessageId String 123

成功时消息ID。

Message String xxx

分析失败时错误信息。

Percent Long 100

转码进度。

取值范围:0~100

PipelineId String 88c6ca184c0e*****a5b665e2a126797

管道ID。

Priority String 8

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

  • 取值范围:[1, 10]
  • 最高优先级:10
  • 默认值:10
State String Success

作业状态。

分为Submitted、Analyzing、Success、Fail

TemplateList Array of Template

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

Template
Audio Struct

音频编解码配置。

Bitrate String 128

输出文件的音频码率。

  • 取值范围:[8,1000]
  • 单位:Kbps
  • 默认值:128
Channels String 2

声道数。

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

音频编解码格式。

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

音频编码预置。

当Codec为aac时可以设置如下范围中的值:aac_low、aac_he、aac_he_v2、aac_ld、aac_eld

Qscale String 15

音频质量控制度

  • 取值范围:[1,31]
Samplerate String 44100

采样率。

  • 支持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 10

分片时长。

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

模板名称。

State String Normal

模板的状态,分为Normal、Deleted。

TransConfig Struct

转码通用配置。

TransMode String onepass

转码模式。

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

视频编解码配置。

Bitrate String 1000

视频平均码率。

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

视频平均码率范围。

Max String 1500

总码率上限,

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

总码率下限。

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

缓冲区大小。

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

编解码格式。

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

码率-质量控制因子。

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

独立去噪算法强度

-取值范围: [1, 9]

Fps String 25

帧率。

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

关键帧间最大帧数。

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

高。

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

视频码率峰值。

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

视频颜色格式。

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

Preset String medium

视频算法器预置。

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

编码级别。

支持baseline、main、high。

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

视频质量控制度

  • 取值范围:[1,31]
ScanMode String interlaced

扫描模式。

支持interlaced、progressive

Width String 1280

宽。

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

用户自定义数据。

NonExistAnalysisJobIds List

不存在的模板分析作业ID列表,无数据时该结构不返回。

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

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=QueryAnalysisJobList
&AnalysisJobIds=88c6ca184c0e*****a5b665e2a126797
&<公共请求参数>

正常返回示例

XML格式

<QueryAnalysisJobListResponse>
  <RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
  <AnalysisJobList>
        <AnalysisJob>
              <Id>88c6ca184c0e*****a5b665e2a126797</Id>
              <InputFile>
                    <Bucket>example-bucket</Bucket>
                    <Location>oss-cn-hangzhou</Location>
                    <Object>example.flv</Object>
              </InputFile>
              <AnalysisConfig>
                    <QualityControl>
                          <RateQuality>25</RateQuality>
                          <MethodStreaming>network</MethodStreaming>
                    </QualityControl>
              </AnalysisConfig>
              <UserData>testid-001</UserData>
              <State>Success</State>
              <Code></Code>
              <Message></Message>
              <Percent>100</Percent>
              <PipelineId>88c6ca184c0e*****a5b665e2a126797</PipelineId>
              <CreationTime>2014-01-10T12:00:00Z</CreationTime>
              <TemplateList>
                    <Template>
                          <Id>S00000000-000020</Id>
                          <Name>FLV-UD</Name>
                          <Container>
                                <Format>flv</Format>
                          </Container>
                          <Video>
                                <Codec>Auto</Codec>
                                <Profile>Auto</Profile>
                                <Bitrate>Auto</Bitrate>
                                <Crf>Auto</Crf>
                                <Width>Auto</Width>
                                <Height>Auto</Height>
                                <Fps>Auto</Fps>
                                <Gop>Auto</Gop>
                          </Video>
                          <Audio>
                                <Codec>AAC</Codec>
                                <Samplerate>44100</Samplerate>
                                <Bitrate>Auto</Bitrate>
                                <Channels>Auto</Channels>
                          </Audio>
                          <State>Normal</State>
                    </Template>
              </TemplateList>
        </AnalysisJob>
  </AnalysisJobList>
</QueryAnalysisJobListResponse>

JSON格式

{
    "QueryAnalysisJobListResponse": {
        "RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
        "AnalysisJobList": {
            "AnalysisJob": {
                "Id": "88c6ca184c0e*****a5b665e2a126797",
                "InputFile": {
                    "Bucket": "example-bucket",
                    "Location": "oss-cn-hangzhou",
                    "Object": "example.flv"
                },
                "AnalysisConfig": {
                    "QualityControl": {
                        "RateQuality": 25,
                        "MethodStreaming": "network"
                    }
                },
                "UserData": "testid-001",
                "State": "Success",
                "Code": "",
                "Message": "",
                "Percent": 100,
                "PipelineId": "88c6ca184c0e*****a5b665e2a126797",
                "CreationTime": "2014-01-10T12:00:00Z",
                "TemplateList": {
                    "Template": {
                        "Id": "S00000000-000020",
                        "Name": "FLV-UD",
                        "Container": {
                            "Format": "flv"
                        },
                        "Video": {
                            "Codec": "Auto",
                            "Profile": "Auto",
                            "Bitrate": "Auto",
                            "Crf": "Auto",
                            "Width": "Auto",
                            "Height": "Auto",
                            "Fps": "Auto",
                            "Gop": "Auto"
                        },
                        "Audio": {
                            "Codec": "AAC",
                            "Samplerate": 44100,
                            "Bitrate": "Auto",
                            "Channels": "Auto"
                        },
                        "State": "Normal"
                    }
                }
            }
        }
    }
}

错误码

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