Tous les produits
Search
Centre de documentation

:QueryJobList

Dernière mise à jour :Aug 07, 2026

Interroge par lot les travaux de transcodage à l'aide de leurs identifiants.

Description de l'opération

  • Cette API vous permet d'interroger jusqu'à 10 travaux de transcodage à la fois.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

  • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

  • API : l'API que vous pouvez appeler pour exécuter l'action.

  • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

  • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

    • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

    • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

  • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

  • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

mts:QueryJobList

get

*All Resource

*

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

JobIds

string

Non

Identifiants des travaux de transcodage.

  • Vous pouvez interroger jusqu'à 10 travaux à la fois. Séparez plusieurs identifiants par des virgules (,).

  • Vous pouvez obtenir les identifiants des travaux depuis la console MPS > Gestion des tâches, ou à partir des paramètres de réponse de l'API SubmitJobs.

Remarque

Si ce paramètre n'est pas spécifié, le code d'erreur InvalidParameter (paramètre non valide) sera renvoyé.

bb558c1cc25b45309aab5be44d19****,d1ce4d3efcb549419193f50f1fcd****

Éléments de réponse

Élément

Type

Description

Exemple

object

Paramètres de réponse.

NonExistJobIds

object

String

array

Les identifiants des tâches inexistantes.

string

Liste des identifiants des tâches de transcodage inexistantes. Cette structure n'est pas renvoyée lorsqu'il n'y a pas de données.

d1ce4d3efcb549419193f50f1fcd****

RequestId

string

L'identifiant de la requête.

197ADF44-104C-514C-9F92-D8924CB34E2A

JobList

object

Job

array<object>

La collection des tâches de transcodage.

array<object>

Les informations détaillées sur la tâche de transcodage.

CreationTime

string

Job creation time.

2014-01-10T12:00:00Z

Percent

integer

Transcoding progress.

100

FinishTime

string

Job completion time.

2014-01-10T12:20:25Z

State

string

Job status.

  • Submitted: The job has been submitted.

  • Transcoding: Transcoding is in progress.

  • TranscodeSuccess: Transcoding succeeded.

  • TranscodeFail: Transcoding failed.

  • TranscodeCancelled: Transcoding was cancelled.

TranscodeSuccess

JobId

string

Task ID.

31fa3c9ca8134fb4b0b0f7878301****

Code

string

Error code when the task fails. This parameter is not returned on success.

InvalidParameter.NullValue

Message

string

Error message when the task fails. This parameter is not returned on success.

The specified parameter "%s" cannot be null.

Output

object

Job output.

Video

object

Video configuration.

Bufsize

string

Buffer size.

  • Unit: Kb.

  • Default value: 6000.

6000

Degrain

string

Independent denoising algorithm strength.

5

BitrateBnd

object

Video average bitrate range.

Max

string

Maximum bitrate.

1000

Min

string

Minimum bitrate.

300

PixFmt

string

Video color format. Range: standard color formats such as yuv420p, yuvj420p.

yuv420p

Pad

string

Video padding (black bars).

  • Unit: px.

  • Parameter format: width:height:left:top.

1280:800:0:140

Codec

string

Codec format.

  • Supports H.264 and H.265.

  • Default value: H.264.

H.264

Height

string

Height.

  • Unit: px.

  • Default value: original video height.

720

Qscale

string

Video quality control factor.

15

Crop

string

Video cropping. Two methods are supported:

  • Auto-detect black bars and crop by setting the value to border.

  • Custom cropping with the format width:height:left:top.

1280:800:0:140

Bitrate

string

Video average bitrate. Unit: Kbps.

500

Maxrate

string

Video peak bitrate. Unit: Kbps.

3000

MaxFps

string

Maximum frame rate.

60

Profile

string

Encoding profile. Supports baseline, main, and high.

Remarque

If you have multiple resolutions, it is recommended to configure the lowest resolution as baseline to ensure playback on low-end devices. Configure other resolutions as main or high.

  • baseline: For mobile devices.

  • main: For standard resolution devices.

  • high: For high resolution devices.

  • Default value: high.

high

Crf

string

Bitrate-quality control factor.

  • Default value: 23 for H.264 codec, 26 for H.265 codec.

  • If Crf is set, the Bitrate setting will be overridden.

26

Gop

string

Maximum time interval or maximum number of frames between keyframes. Unit: seconds.

  • Default value: 250.

  • No unit when specifying the maximum number of frames.

250

Width

string

Width.

  • Unit: px.

  • Default value: original video width.

1280

Fps

string

Frame rate.

  • Unit: fps.

  • When the input file frame rate exceeds 60, it is set to 60.

  • Default value: uses the input file frame rate.

25

Preset

string

Video algorithm preset. Default value: medium. Valid values:

  • veryfast: Very fast.

  • fast: Fast.

  • medium: Medium.

  • slow: Slow.

  • slower: Slower.

medium

ScanMode

string

Scan mode. Valid values:

  • Not set: Uses the original mode of the input file.

  • auto: Auto deinterlacing.

  • progressive: Progressive scan.

  • interlaced: Interlaced scan.

  • Default value: Empty, meaning not set.

Best practice: Although interlaced scanning saves more data than progressive scanning, the image quality is poor, so mainstream video production now uses progressive scanning.

  • If you set progressive or interlaced but it does not match the original video mode, transcoding will fail.

  • It is recommended to set the original video mode or auto deinterlacing to improve compatibility.

interlaced

ResoPriority

string

Resource priority.

1

TransConfig

object

General transcoding configuration.

Remarque

If this value is set in the request parameters, it overrides the corresponding parameter in the specified transcoding template.

IsCheckAudioBitrate

string

Whether to check the audio bitrate. When the output audio bitrate exceeds the source audio bitrate, the output audio bitrate is treated as equal to the source audio bitrate, meaning the configured audio bitrate parameter will not take effect. This value has lower priority than IsCheckAudioBitrateFail.

  • true: Check.

  • false: Do not check.

  • Default value:
    • When the parameter is empty and the codec differs from the input source: false.

    • When the parameter is empty and the codec is the same as the input source: true.

false

TransMode

string

Transcoding mode.

  • Valid values: onepass, twopass, CBR.

  • Default value: onepass.

onepass

IsCheckReso

string

Whether to check the resolution. If the output resolution exceeds the input resolution (determined by width or height), the output resolution is treated as equal to the input resolution.

  • true: Check.

  • false: Do not check.

  • Default value: false.

false

IsCheckVideoBitrateFail

string

Whether to check the bitrate. When the output video bitrate exceeds the source video bitrate, transcoding is not performed and a transcoding failure is returned directly. This value has higher priority than IsCheckVideoBitrate.

  • true: Check.

  • false: Do not check.

  • Default value: false.

false

AdjDarMethod

string

Resolution rewriting method. Default value: none. Valid values: rescale, crop, pad, none.

none

IsCheckVideoBitrate

string

Whether to check the video bitrate. If the output video bitrate exceeds the input video bitrate, the output video bitrate is treated as equal to the input video bitrate.

  • true: Check.

  • false: Do not check.

  • Default value: false.

false

IsCheckResoFail

string

Whether to check the resolution. If the output resolution exceeds the input resolution (determined by width or height), a transcoding failure is returned.

  • true: Check.

  • false: Do not check.

  • Default value: false.

false

IsCheckAudioBitrateFail

string

Whether to check the audio bitrate. When the output audio bitrate exceeds the source audio bitrate, transcoding is not performed and a transcoding failure is returned directly. This value has higher priority than IsCheckAudioBitrate.

  • true: Check.

  • false: Do not check.

  • Default value: false.

false

Encryption

object

Data encryption, only supports m3u8 format output.

Type

string

Encryption type. Valid value: hls-aes-128.

hls-aes-128

Key

string

Encryption key for the video.

encryptionkey128

KeyType

string

Key encryption method. Valid values: Base64, KMS.

Remarque

For example, if the key is "encryptionkey128", then Base64("encryptionkey128") or KMS(Base64("encryptionkey128")).

Base64

Id

string

Encryption ID.

31fa3c9ca8134f9cec2b4b0b0f78****

KeyUri

string

Access URL for the key, encoded using BASE64.

https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/

SkipCnt

string

Number of initial unencrypted segments (allows the video to start playing quickly).

3

WaterMarkList

object

WaterMark

array<object>

Watermark list.

array<object>

Watermark details.

Type

string

Watermark type. If this parameter is set in the request, it overrides the corresponding parameter in the watermark template. For more information, see Parameter Details. Valid values:

  • Image: Image watermark.

  • Text: Text watermark.

Image

ReferPos

string

Watermark position. If this value is set in the request parameters, it overrides the corresponding parameter in the watermark template. Valid values:

  • TopRight: Top right.

  • TopLeft: Top left.

  • BottomRight: Bottom right.

  • BottomLeft: Bottom left.

TopRight

Dx

string

Horizontal offset of the watermark image relative to the output video. If this value is set in the request parameters, it overrides the corresponding parameter in the watermark template. Default value: 0. The value can be in two forms:

  • Integer: Represents the offset in pixels.

    • Range: [8,4096].

    • Unit: px.

  • Decimal: Represents the ratio of the horizontal offset to the output resolution width.

    • Range: (0,1).

    • Supports four decimal places, for example: 0.9999. Excess decimal places are automatically discarded.

100

Width

string

Watermark image width. If this value is set in the request parameters, it overrides the corresponding watermark image width in the watermark template. The value can be in two forms:

  • Integer: Represents the watermark image width in pixels.

    • Range: [8, 4096].

    • Unit: px.

  • Decimal: Represents the ratio relative to the output video resolution width.

    • Range: (0,1).

    • Supports 4 decimal places, for example: 0.9999. Excess decimal places are automatically discarded.

50

Height

string

Watermark image height. If this value is set in the request parameters, it overrides the corresponding watermark image height in the watermark template. The value can be in two forms:

  • Integer: Represents the watermark image height in pixels.

    • Range: [8, 4096].

    • Unit: px.

  • Decimal: Represents the ratio relative to the output video resolution height.

    • Range: (0,1).

    • Supports 4 decimal places, for example: 0.9999. Excess decimal places are automatically discarded.

50

InputFile

object

Watermark input file. Currently supports png images and mov files as input files.

Object

string

OSS Object of the input file.

example-logo-****.png

Location

string

OSS Location of the input file.

oss-cn-hangzhou

Bucket

string

OSS Bucket of the input file.

example-bucket

WaterMarkTemplateId

string

Watermark template ID.

88c6ca184c0e47098a5b665e2a12****

Dy

string

Vertical offset of the watermark image relative to the output video. If this value is set in the request parameters, it overrides the corresponding vertical offset in the watermark template. The value can be in two forms:

  • Integer: Represents the vertical offset in pixels.

    • Range: [8, 4096].

    • Unit: px.

  • Decimal: Represents the ratio of the vertical offset relative to the output video.

    • Range: (0,1).

    • Supports 4 decimal places, for example: 0.9999. Excess decimal places are automatically discarded.

100

WaterMarkConfigUrl

string

Watermark configuration file URL.

http://example.com/configure

DeWatermark

string

Dewatering (blur processing), JSON object. For more information, see the blur processing details in Parameter Details.

{"0":[{"l":10,"t":10,"w":10,"h":10},{"l":100,"t":0.1,"w":10,"h":10}],"128000":[],"250000":[{"l":0.2,"t":0.1,"w":0.01,"h":0.05}]}

M3U8NonStandardSupport

object

M3U8 non-standard support, JSON object. For more information, see the M3U8 non-standard parameter support details in Parameter Details.

TS

object

JSON object, TS file related non-standard support. For more information, see the TS parameter support details in Parameter Details.

SizeSupport

boolean

Whether to support outputting the TS file size in the m3u8 file. Valid values:

  • true: Supported.

  • false: Not supported.

true

Md5Support

boolean

Whether to support outputting the TS MD5 value in the m3u8 file. Valid values:

  • true: Supported.

  • false: Not supported.

true

Priority

string

Priority of the task within its corresponding pipeline.

  • Highest priority: 10.

  • Default value: 6.

6

Audio

object

Audio configuration.

Remarque

If audio configuration is specified in the request parameters, it overrides the corresponding parameter in the specified transcoding template.

Profile

string

Audio encoding preset. When Codec is aac, valid values are: aaclow, aache, aachev2, aacld, aaceld.

aaclow

Codec

string

Audio codec format.

  • Supports aac, mp3, vorbis, flac.

  • Default value: aac.

aac

Samplerate

string

Sample rate.

  • Supports 22050, 32000, 44100, 48000, 96000.

  • Unit: Hz.

  • Default value: 44100.

Remarque

When the video container format is flv and the audio codec is mp3, sample rates of 32000, 48000, and 96000 are not supported. When the audio codec is mp3, a sample rate of 96000 is not supported.

44100

Qscale

string

Audio quality control factor.

15

Channels

string

Number of audio channels.

  • Supports 1, 2, 3, 4, 5, 6, 7, 8.

  • Default value: 2.

2

Volume

object

Volume configuration.

Method

string

Volume adjustment method. Valid values:

  • auto: Auto adjustment.

  • dynamic: Dynamic adjustment.

  • linear: Linear adjustment.

auto

Level

string

Volume adjustment level. Default value: -20db.

-20

Bitrate

string

Audio bitrate of the output file.

  • Unit: Kbps.

  • Default value: 128.

128

AudioStreamMap

string

Audio stream index.

  • Format: 0:a:{index}, example: 0:a:0.

  • The index refers to the subscript of the audio stream list, starting from 0.

  • If not set, the default audio stream is selected.

0:a:0

MergeList

object

Merge

array<object>

Merge settings. Supports up to 4 MergeURLs.

object

Merge details.

Start

string

Start time point.

  • Format: hh:mm:ss[.SSS] or sssss[.SSS].

  • Example: 01:59:59.999 or 32000.23.

01:59:59.999

RoleArn

string

Role information used for delegated authorization.

acs:ram:::role/

MergeURL

string

Merge segment address.

  • Example: http://example-bucket-.oss-cn-hangzhou.aliyuncs.com/example-object.flv.

  • The Object must be URL-encoded using UTF-8 encoding. For more information, see URL Encoding Description.

http://example-bucket.oss-cn-hangzhou.aliyuncs.com/example-object.flv

Duration

string

Duration.

  • Format: hh:mm:ss[.SSS] or sssss[.SSS].

  • Example: 01:59:59.999 or 32000.23.

01:59:59.999

SuperReso

object

Resolution follows source.

IsHalfSample

string

Whether to obtain sample rate related parameters. Valid values:

  • true: Yes.

  • false: No.

true

UserData

string

User-defined data.

testid-001

ExtendData

string

User-defined extension field.

testid-002

OutSubtitleList

object

OutSubtitle

array<object>

Output subtitle list.

array<object>

Output subtitle details.

Map

string

Video track. Format: 0:{stream}:{stream_index}, i.e., 0:v:{video_index}. The stream value v indicates a video stream, and the index refers to the subscript of the stream list, starting from 0.

0:v:0

OutSubtitleFile

object

Output file details.

RoleArn

string

Role information used for delegated authorization.

acs:ram:::role/

Object

string

OSS Object of the output file.

example.flv

Location

string

OSS Location of the output file.

oss-cn-hangzhou

Bucket

string

OSS Bucket of the output file.

exampleBucket

Success

boolean

Whether successful. Valid values:

  • true: Succeeded.

  • false: Failed.

true

Message

string

Error message when job creation fails. This parameter is not returned when the job is created successfully.

The specified parameter “%s” cannot be null.

VideoStreamMap

string

Video stream index. The index starts from 0 and refers to the subscript of the video stream list. If not set, the default video stream is selected.

0

OutputFile

object

Output file.

RoleArn

string

Role information used for delegated authorization.

acs:ram:::role/

Object

string

OSS Object of the output file.

example-output.flv

Location

string

OSS Location of the output file.

oss-cn-hangzhou

Bucket

string

OSS Bucket of the output file.

example-bucket

Rotate

string

Video rotation angle.

90

Container

object

Container.

Format

string

Container format.

  • Default value: mp4.

  • For video transcoding: flv, mp4, HLS (m3u8+ts), MPEG-DASH (MPD+fMP4).

  • For audio transcoding: mp3, mp4, ogg, flac, m4a.

  • For images: gif, WEBP. When the container format is gif, VideoCodec can only be set to GIF.

  • When the container format is webp, VideoCodec can only be set to WEBP.

  • When the container format is flv, VideoCodec cannot be set to H265.

mp4

Clip

object

Clip segment.

TimeSpan

object

Clip time span.

Seek

string

Start time point.

  • Format: hh:mm:ss[.SSS].

  • Example: 01:59:59.999.

Or

  • Format: sssss[.SSS].

  • Example: 32000.23.

01:59:59.999

Duration

string

Duration.

  • Format: hh:mm:ss[.SSS].

  • Example: 01:00:59.999.

Or

  • Format: sssss[.SSS].

  • Example: 32000.23.

01:00:59.999

MergeConfigUrl

string

Merge configuration file URL. Only one of MergeList and MergeConfigUrl can be used.

  • The configuration file specified by MergeConfigUrl supports up to 50 merge segments.

  • MergeConfigUrl is the URL of the merge configuration file. Only configuration files stored on OSS are supported, and MPS must have access permissions. For the file content format, see the merge parameter details.

  • Example of mergeConfigfile content: {"MergeList":[{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4"}]}.

https://ceshi-***.oss-cn-shanghai.aliyuncs.com/ccc/p0903q9wkkb.m3u8

OpeningList

object

Opening

array<object>

Opening slate list, JSON object.

object

Opening slate details.

openUrl

string

OSS URL of the opening slate video.

http://example.oss-cn-shanghai.aliyuncs.com/t5.mp4

Start

string

Start time relative to the main video.

  • Delay from 0 before displaying the opening slate video.

  • Unit: seconds.

  • Default value: 0.

0

Width

string

Width.

  • Range: (0,4096), -1, full.

  • -1 represents the source value.

  • full means fill the screen.

  • Default value: -1.

-1

Height

string

Height.

  • Range: (0,4096), -1, full.

  • -1 represents the source value.

  • full means fill the screen.

  • Default value: -1.

-1

MuxConfig

object

Transcoding mux configuration. If this parameter is set in the request parameters, it overrides the corresponding parameter in the specified transcoding template.

Webp

object

Mux configuration for WebP.

Loop

string

Loop count.

0

Gif

object

Mux configuration for GIF.

FinalDelay

string

Final frame pause time. Unit: centiseconds.

0

DitherMode

string

Palette color dithering mode. Valid values: sierra, bayer.

bayer

Loop

string

Loop count.

0

IsCustomPalette

string

Custom palette feature. Valid values:

  • true: Custom.

  • false: Not custom.

false

Segment

object

Segment configuration, JSON object.

Duration

string

Segment duration. Unit: seconds.

20

TailSlateList

object

TailSlate

array<object>

Tail slate list.

object

Tail slate details.

Start

string

Tail slate video start time.

00000.00

BgColor

string

Background color to fill blank areas when the tail slate video dimensions are smaller than the main video. Default value: White. For valid values, see bgcolor.

White

IsMergeAudio

boolean

Whether to merge the audio content of the tail slate video. Valid values:

  • true: Merge.

  • false: Do not merge.

true

Width

string

Width. Range: (0, 4096), -1, full.

  • -1 represents the source value.

  • full means fill the screen.

  • Default value: -1.

-1

Height

string

Height.

  • Range: (0, 4096), -1, full.

  • -1 represents the source value.

  • full means fill the screen.

  • Default value: -1.

-1

BlendDuration

string

Duration of the transition between the main video and the tail slate video. The transition effect is a fade: the last frame of the main video is displayed while the tail slate video plays, with the last frame of the main video gradually darkening and the tail slate video gradually brightening. Unit: seconds. Default value: 0.

0

TailUrl

string

OSS URL of the tail slate video.

http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv

TemplateId

string

Template ID.

S00000001-200010

SubtitleConfig

object

Subtitle configuration.

ExtSubtitleList

object

ExtSubtitle

array<object>

External subtitle list.

array<object>

Subtitle details.

CharEnc

string

External subtitle character encoding.

  • Valid values: UTF-8, GBK, BIG5, auto.

  • Default value: auto.

Remarque

When external subtitle character encoding is set to auto, detection errors may occur. It is recommended to specify a specific character encoding.

auto

FontName

string

Font name for converting external subtitles to hardcoded subtitles. Default value: SimSum. For more information, see Font List.

"WenQuanYi Zen Hei", "Yuanti SC Regular", "SimSun"

Input

object

External input subtitle file.

  • Currently supports srt and ass formats. For more information, see the Input parameter in Parameter Details.

  • Example: {"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.srt"}.

Object

string

OSS Object of the input file.

example-output.flv

Location

string

OSS Location of the input file.

oss-cn-hangzhou

Bucket

string

OSS Bucket of the input file.

example-bucket-****

SubtitleList

object

Subtitle

array<object>

Subtitle list.

object

Subtitle details.

Map

string

Audio track. Format: 0:{stream}:{stream_index}, i.e., 0:a:{audio_index}. The stream value a indicates an audio stream, and the index refers to the subscript of the audio stream list, starting from 0.

0:a:0

Properties

object

Media properties.

Width

string

Video width.

720

Height

string

Video height.

1280

SourceLogos

object

object

Keyword details.

Source

string

Keyword.

example

Duration

string

Duration.

17

Fps

string

Frame rate.

30

Bitrate

string

Bitrate.

490

FileFormat

string

File format.

mp4

Streams

object

Stream information.

VideoStreamList

object

VideoStream

array<object>

Video stream list.

array<object>

Video stream details.

Index

string

Video stream index, identifying the position of the video stream in the overall media stream.

0

Timebase

string

Timebase.

1/15360

AvgFPS

string

Average frame rate.

30.0

PixFmt

string

Pixel format.

yuv420p

Sar

string

Sample aspect ratio (SAR).

1:1

Lang

string

Language. For more information, see FFmpeg language definitions and ISO-639.

eng

CodecLongName

string

Codec long name.

H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10

Height

string

Video resolution height.

1280

NumFrames

string

Total number of frames.

30

Bitrate

string

Bitrate.

421.117

CodecTagString

string

Codec tag string.

avc1

HasBFrames

string

Whether B-frames are present.

2

Profile

string

Encoding preset.

high

StartTime

string

Start time.

0.000000

NetworkCost

object

Network bandwidth consumption.

PreloadTime

string

Preload time.

8

AvgBitrate

string

Average bitrate.

300

CostBandwidth

string

Maximum bandwidth consumption.

10

Dar

string

Display aspect ratio (DAR).

9:16

CodecName

string

Codec short name.

h264

Width

string

Video resolution width, numeric value.

720

Duration

string

Duration.

17.233333

Fps

string

Frame rate.

30.0

CodecTag

string

Codec tag.

0x31637661

CodecTimeBase

string

Codec timebase.

1/60

Level

string

Encoding level.

31

colorTransfer

string

Color transfer.

bt709

colorPrimaries

string

Color primaries.

bt709

bitsPerRawSample

string

Number of bits per raw sample.

8

AudioStreamList

object

AudioStream

array<object>

Audio stream list.

object

Audio stream details.

Timebase

string

Timebase.

1/32000

Index

string

Audio stream index, identifying the position of the audio stream in the overall media stream.

1

SampleFmt

string

Sample format.

fltp

ChannelLayout

string

Channel layout.

mono

Lang

string

Language. For more information, see FFmpeg language definitions and ISO-639.

und

Samplerate

string

Sample rate.

32000

CodecLongName

string

Codec long name.

AAC (Advanced Audio Coding)

Channels

string

Number of channels.

1

NumFrames

string

Total number of frames.

50

Bitrate

string

Bitrate.

64.136

CodecTagString

string

Codec tag string.

mp4

StartTime

string

Start time.

0.064000

CodecName

string

Codec short name.

aac

Duration

string

Duration.

17.223562

CodecTag

string

Codec tag.

0x6134706d

CodecTimeBase

string

Codec timebase.

1/32000

SubtitleStreamList

object

SubtitleStream

array<object>

Subtitle stream list.

object

Subtitle stream details.

Index

string

Subtitle stream index. Identifies the position of the subtitle stream in the overall media stream.

1

Lang

string

Language. For more information, see FFmpeg language definitions and ISO-639.

eng

Format

object

Format information.

StartTime

string

Start time.

-0.064000

NumPrograms

string

Total number of program streams.

0

Size

string

File size.

1057273

NumStreams

string

Total number of media streams.

2

FormatLongName

string

Container/format long name.

QuickTime / MOV

Duration

string

Total duration.

17.234000

Bitrate

string

Total bitrate.

490.784

FormatName

string

Container/format short name. Valid values: mov, mp4, m4a, 3gp, 3g2, mj2.

mov

FileMd5

string

MD5 checksum of the result file

ad195fd1317a761d4425232867759d1e

FileSize

string

File size.

1057273

MultiSpeedInfo

object

Speed-up job information. Only available for tasks submitted through the speed-up pipeline (not available for the legacy speed-up version).

Enable

string

Whether the speed-up switch is enabled.

true

Code

string

Error code (description when speed-up is not actually enabled).

Boost.NotNeedSpeed

Message

string

Error message (description when speed-up is not actually enabled).

success

SettingSpeed

integer

Configured speed.

30

DowngradePolicy

string

Downgrade policy when speed-up is not supported.

NormalSpeed

RealSpeed

number

Actual speed-up value.

6.576886940181647

Duration

number

Output video duration.

21.0

TimeCost

number

Task time cost.

3.193

PipelineId

string

Pipeline ID.

88c6ca184c0e47b665e2a1267971****

Input

object

Job input.

Object

string

OSS Object of the input file.

video_01.mp4

Location

string

OSS Location of the input file.

oss-cn-shanghai

Bucket

string

OSS Bucket of the input file.

exampleBucket

MNSMessageResult

object

MNS message result notifying the user of job completion.

MessageId

string

Message ID on success.

123

ErrorMessage

string

Error message on failure. This parameter is not returned on success.

The resource operated “%s” cannot be found.

ErrorCode

string

Error code on failure. This parameter is not returned on success.

InvalidParameter.ResourceNotFound

SubmitTime

string

Time when the task was dequeued and submitted for execution.

2021-03-04T06:44:43Z

Définition du format du message de rappel

Lorsque l'état d'exécution d'une tâche de transcodage change, MPS envoie un message à la file d'attente spécifiée par l'utilisateur (pour savoir comment spécifier la file d'attente de rappel, consultez l'API UpdatePipeline). Le corps du message est une chaîne JSON contenant les champs suivants :

{
  "Type": "Transcode",
  "State": "Success",
  "JobId": "39f8e0bc005e4f309379701645f4****",
  "UserData": "{\\"key\\":\\"value\\"}",
  "RequestId": "25818875-5F78-4A13-BEF6-D7393642****"
}
NomTypeDescription
TypeStringChaîne fixe "Transcode", indiquant une tâche de transcodage.
JobIdStringIdentifiant unique de la tâche.
StateStringÉtat actuel de la tâche, cohérent avec le State dans QueryJobList.
UserDataStringUserData transmis par l'utilisateur dans SubmitJobs.

Exemples

JSON format

{
  "NonExistJobIds": {
    "String": [
      "d1ce4d3efcb549419193f50f1fcd****"
    ]
  },
  "RequestId": "197ADF44-104C-514C-9F92-D8924CB34E2A",
  "JobList": {
    "Job": [
      {
        "CreationTime": "2014-01-10T12:00:00Z",
        "Percent": 100,
        "FinishTime": "2014-01-10T12:20:25Z",
        "State": "TranscodeSuccess",
        "JobId": "31fa3c9ca8134fb4b0b0f7878301****",
        "Code": "InvalidParameter.NullValue",
        "Message": "The specified parameter \"%s\" cannot be null.",
        "Output": {
          "Video": {
            "Bufsize": "6000",
            "Degrain": "5",
            "BitrateBnd": {
              "Max": "1000",
              "Min": "300"
            },
            "PixFmt": "yuv420p",
            "Pad": "1280:800:0:140",
            "Codec": "H.264",
            "Height": "720",
            "Qscale": "15",
            "Crop": "1280:800:0:140",
            "Bitrate": "500",
            "Maxrate": "3000",
            "MaxFps": "60",
            "Profile": "high",
            "Crf": "26",
            "Gop": "250",
            "Width": "1280",
            "Fps": "25",
            "Preset": "medium",
            "ScanMode": "interlaced",
            "ResoPriority": "1"
          },
          "TransConfig": {
            "IsCheckAudioBitrate": "false",
            "TransMode": "onepass",
            "IsCheckReso": "false",
            "IsCheckVideoBitrateFail": "false",
            "AdjDarMethod": "none",
            "IsCheckVideoBitrate": "false",
            "IsCheckResoFail": "false",
            "IsCheckAudioBitrateFail": "false"
          },
          "Encryption": {
            "Type": "hls-aes-128",
            "Key": "encryptionkey128",
            "KeyType": "Base64",
            "Id": "31fa3c9ca8134f9cec2b4b0b0f78****",
            "KeyUri": "https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/",
            "SkipCnt": "3"
          },
          "WaterMarkList": {
            "WaterMark": [
              {
                "Type": "Image",
                "ReferPos": "TopRight",
                "Dx": "100",
                "Width": "50",
                "Height": "50",
                "InputFile": {
                  "Object": "example-logo-****.png",
                  "Location": "oss-cn-hangzhou",
                  "Bucket": "example-bucket"
                },
                "WaterMarkTemplateId": "88c6ca184c0e47098a5b665e2a12****",
                "Dy": "100"
              }
            ]
          },
          "WaterMarkConfigUrl": "http://example.com/configure",
          "DeWatermark": "{\"0\":[{\"l\":10,\"t\":10,\"w\":10,\"h\":10},{\"l\":100,\"t\":0.1,\"w\":10,\"h\":10}],\"128000\":[],\"250000\":[{\"l\":0.2,\"t\":0.1,\"w\":0.01,\"h\":0.05}]}",
          "M3U8NonStandardSupport": {
            "TS": {
              "SizeSupport": true,
              "Md5Support": true
            }
          },
          "Priority": "6",
          "Audio": {
            "Profile": "aaclow",
            "Codec": "aac",
            "Samplerate": "44100",
            "Qscale": "15",
            "Channels": "2",
            "Volume": {
              "Method": "auto",
              "Level": "-20"
            },
            "Bitrate": "128"
          },
          "AudioStreamMap": "0:a:0",
          "MergeList": {
            "Merge": [
              {
                "Start": "01:59:59.999",
                "RoleArn": "acs:ram:::role/",
                "MergeURL": "http://example-bucket.oss-cn-hangzhou.aliyuncs.com/example-object.flv",
                "Duration": "01:59:59.999"
              }
            ]
          },
          "SuperReso": {
            "IsHalfSample": "true"
          },
          "UserData": "testid-001",
          "ExtendData": "testid-002",
          "OutSubtitleList": {
            "OutSubtitle": [
              {
                "Map": "0:v:0",
                "OutSubtitleFile": {
                  "RoleArn": "acs:ram:::role/",
                  "Object": "example.flv",
                  "Location": "oss-cn-hangzhou",
                  "Bucket": "exampleBucket"
                },
                "Success": true,
                "Message": "The specified parameter “%s” cannot be null."
              }
            ]
          },
          "VideoStreamMap": "0",
          "OutputFile": {
            "RoleArn": "acs:ram:::role/",
            "Object": "example-output.flv",
            "Location": "oss-cn-hangzhou",
            "Bucket": "example-bucket"
          },
          "Rotate": "90",
          "Container": {
            "Format": "mp4"
          },
          "Clip": {
            "TimeSpan": {
              "Seek": "01:59:59.999",
              "Duration": "01:00:59.999"
            }
          },
          "MergeConfigUrl": "https://ceshi-***.oss-cn-shanghai.aliyuncs.com/ccc/p0903q9wkkb.m3u8",
          "OpeningList": {
            "Opening": [
              {
                "openUrl": "http://example.oss-cn-shanghai.aliyuncs.com/t5.mp4",
                "Start": "0",
                "Width": "-1",
                "Height": "-1"
              }
            ]
          },
          "MuxConfig": {
            "Webp": {
              "Loop": "0"
            },
            "Gif": {
              "FinalDelay": "0",
              "DitherMode": "bayer",
              "Loop": "0",
              "IsCustomPalette": "false"
            },
            "Segment": {
              "Duration": "20"
            }
          },
          "TailSlateList": {
            "TailSlate": [
              {
                "Start": "00000.00",
                "BgColor": "White",
                "IsMergeAudio": true,
                "Width": "-1",
                "Height": "-1",
                "BlendDuration": "0",
                "TailUrl": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv"
              }
            ]
          },
          "TemplateId": "S00000001-200010",
          "SubtitleConfig": {
            "ExtSubtitleList": {
              "ExtSubtitle": [
                {
                  "CharEnc": "auto",
                  "FontName": "\"WenQuanYi Zen Hei\", \"Yuanti SC Regular\", \"SimSun\"",
                  "Input": {
                    "Object": "example-output.flv",
                    "Location": "oss-cn-hangzhou",
                    "Bucket": "example-bucket-****"
                  }
                }
              ]
            },
            "SubtitleList": {
              "Subtitle": [
                {
                  "Map": "0:a:0"
                }
              ]
            }
          },
          "Properties": {
            "Width": "720",
            "Height": "1280",
            "SourceLogos": {
              "SourceLogo": [
                {
                  "Source": "example"
                }
              ]
            },
            "Duration": "17",
            "Fps": "30",
            "Bitrate": "490",
            "FileFormat": "mp4",
            "Streams": {
              "VideoStreamList": {
                "VideoStream": [
                  {
                    "Index": "0",
                    "Timebase": "1/15360",
                    "AvgFPS": "30.0",
                    "PixFmt": "yuv420p",
                    "Sar": "1:1",
                    "Lang": "eng",
                    "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
                    "Height": "1280",
                    "NumFrames": "30",
                    "Bitrate": "421.117",
                    "CodecTagString": "avc1",
                    "HasBFrames": "2",
                    "Profile": "high",
                    "StartTime": "0.000000",
                    "NetworkCost": {
                      "PreloadTime": "8",
                      "AvgBitrate": "300",
                      "CostBandwidth": "10"
                    },
                    "Dar": "9:16",
                    "CodecName": "h264",
                    "Width": "720",
                    "Duration": "17.233333",
                    "Fps": "30.0",
                    "CodecTag": "0x31637661",
                    "CodecTimeBase": "1/60",
                    "Level": "31",
                    "colorTransfer": "bt709",
                    "colorPrimaries": "bt709",
                    "bitsPerRawSample": "8"
                  }
                ]
              },
              "AudioStreamList": {
                "AudioStream": [
                  {
                    "Timebase": "1/32000",
                    "Index": "1",
                    "SampleFmt": "fltp",
                    "ChannelLayout": "mono",
                    "Lang": "und",
                    "Samplerate": "32000",
                    "CodecLongName": "AAC (Advanced Audio Coding)",
                    "Channels": "1",
                    "NumFrames": "50",
                    "Bitrate": "64.136",
                    "CodecTagString": "mp4",
                    "StartTime": "0.064000",
                    "CodecName": "aac",
                    "Duration": "17.223562",
                    "CodecTag": "0x6134706d",
                    "CodecTimeBase": "1/32000"
                  }
                ]
              },
              "SubtitleStreamList": {
                "SubtitleStream": [
                  {
                    "Index": "1",
                    "Lang": "eng"
                  }
                ]
              }
            },
            "Format": {
              "StartTime": "-0.064000",
              "NumPrograms": "0",
              "Size": "1057273",
              "NumStreams": "2",
              "FormatLongName": "QuickTime / MOV",
              "Duration": "17.234000",
              "Bitrate": "490.784",
              "FormatName": "mov"
            },
            "FileMd5": "ad195fd1317a761d4425232867759d1e",
            "FileSize": "1057273"
          },
          "MultiSpeedInfo": {
            "Enable": "true",
            "Code": "Boost.NotNeedSpeed",
            "Message": "success",
            "SettingSpeed": 30,
            "DowngradePolicy": "NormalSpeed",
            "RealSpeed": 6.576886940181647,
            "Duration": 21,
            "TimeCost": 3.193
          }
        },
        "PipelineId": "88c6ca184c0e47b665e2a1267971****",
        "Input": {
          "Object": "video_01.mp4",
          "Location": "oss-cn-shanghai",
          "Bucket": "exampleBucket"
        },
        "MNSMessageResult": {
          "MessageId": "123",
          "ErrorMessage": "The resource operated “%s” cannot be found.",
          "ErrorCode": "InvalidParameter.ResourceNotFound"
        },
        "SubmitTime": "2021-03-04T06:44:43Z"
      }
    ]
  }
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.