Tous les produits
Search
Centre de documentation

:ListJob

Dernière mise à jour :Oct 12, 2026

Répertorie les travaux de transcodage.

Description de l'opération

  • Par défaut, la réponse est triée par ordre décroissant de CreationTime.

  • Cette opération renvoie un maximum d'enregistrements de nœuds créés au cours des 90 derniers jours. Pour une période inférieure à 90 jours, les enregistrements de nœuds sont renvoyés en fonction des paramètres réels.

  • Vous pouvez effectuer une requête filtrée en définissant des paramètres de requête tels que l'état du travail, la plage de temps de création et la file d'attente MPS.

  • Par défaut, les données de différentes régions sous le même compte ne sont pas interconnectées dans ApsaraVideo Media Processing. Avant d'appeler cette opération, vérifiez que les informations de région que vous transmettez correspondent à la région des fichiers à interroger. Sinon, cela peut entraîner un échec de l'appel d'API ou des informations incohérentes.

Limites de QPS

La limite de QPS pour un seul utilisateur est de 100 fois par seconde. Si cette limite est dépassée, les appels d'API seront limités, ce qui peut affecter votre activité. Appelez l'API à une fréquence raisonnable. Pour plus d'informations, consultez Limites de QPS.

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:ListJob

get

*Toutes les ressources.

*

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

NextPageToken

string

Non

Le jeton pour la page suivante. Vous n'avez pas besoin de spécifier ce paramètre dans la première requête. Le service renvoie ce jeton, que vous pouvez inclure dans les requêtes suivantes.

16f01ad6175e4230ac42bb5182cd****

MaximumPageSize

integer

Non

Le nombre maximal d'instances d'exécution de flux de travail multimédia à renvoyer par page.

  • Valeur par défaut : 10.

  • Valeurs valides : 1 à 100.

10

State

string

Non

L'état du travail de transcodage. Valeur par défaut : All. Valeurs valides :

  • All : Tous les états.

  • Submitted : Le travail est soumis.

  • Transcoding : Le travail est en cours de transcodage.

  • TranscodeSuccess : Le transcodage a réussi.

  • TranscodeFail : Le transcodage a échoué.

  • TranscodeCancelled : Le transcodage est annulé.

All

StartOfJobCreatedTimeRange

string

Non

L'heure de début de la plage de temps pendant laquelle les travaux de transcodage ont été créés. Spécifiez l'heure selon la norme ISO 8601 au format YYYY-MM-DDThh:mm:ssZ. L'heure doit être en UTC.

2014-01-10T12:00:00Z

EndOfJobCreatedTimeRange

string

Non

L'heure de fin de la plage de temps pendant laquelle les travaux de transcodage ont été créés. Spécifiez l'heure selon la norme ISO 8601 au format YYYY-MM-DDThh:mm:ssZ. L'heure doit être en UTC.

2014-01-11T12:00:00Z

PipelineId

string

Non

L'identifiant de la file d'attente MPS. Vous pouvez interroger l'identifiant en choisissant Paramètres globaux > Files d'attente et rappels dans la console MPS.

88c6ca184c0e424d5w5b665e2a12****

Éléments de réponse

Élément

Type

Description

Exemple

object

Les paramètres de réponse.

RequestId

string

L'identifiant de la requête.

BC860F04-778A-472F-AB39-E1BF329C1EA8

NextPageToken

string

Le jeton pour la page suivante. Conservez ce jeton et transmettez-le dans la requête suivante.

16f01ad6175e4230ac42bb5182cd****

JobList

object

Job

array<object>

La collection des travaux de transcodage.

array<object>

Les détails du travail de transcodage.

CreationTime

string

L'heure à laquelle le travail a été ajouté. L'heure est affichée en UTC et suit la norme ISO 8601 au format YYYY-MM-DDTHH:mm:ssZ.

2014-01-10T12:00:00Z

Percent

integer

La progression du transcodage.

100

FinishTime

string

L'heure à laquelle le travail a été terminé. L'heure est affichée en UTC et suit la norme ISO 8601 au format YYYY-MM-DDTHH:mm:ssZ.

2014-01-10T12:20:25Z

State

string

L'état du travail. Valeurs valides :

  • Submitted : le travail est soumis.

  • Transcoding : le travail est en cours de transcodage.

  • TranscodeSuccess : le transcodage a réussi.

  • TranscodeFail : le transcodage a échoué.

  • TranscodeCancelled : le transcodage est annulé.

TranscodeSuccess

JobId

string

L'identifiant du travail.

31fa3c9ca8134fb4b0b0f7878301****

Code

string

Le code d'erreur renvoyé lorsque le travail échoue. Ce paramètre n'est pas renvoyé lorsque le travail réussit.

InternalError

Message

string

Le message d'erreur renvoyé lorsque le travail échoue. Ce paramètre n'est pas renvoyé lorsque le travail réussit.

The operation has failed due to some unknown error, exception or failure.

Output

object

La sortie du travail.

Video

object

Les configurations vidéo.

Bufsize

string

La taille de la mémoire tampon.

6000

Degrain

string

L'intensité de l'algorithme de réduction de bruit indépendant.

5

BitrateBnd

object

La plage de débit binaire vidéo.

Max

string

Le débit binaire maximal. Unité : Kbit/s.

1000

Min

string

Le débit binaire minimal. Unité : Kbit/s.

200

PixFmt

string

Le format de couleur vidéo. Valeurs valides : les formats de couleur standard tels que yuv420p et yuvj420p.

yuv420p

Pad

string

Les bordures noires ajoutées à la vidéo. Unité : px.

  • Format du paramètre : largeur:hauteur:gauche:haut.

  • Exemple : 1280:800:0:140.

1280:800:0:140

Codec

string

Le format d'encodage. Valeurs valides : H.264, H.265, GIF et WEBP.

H.264

Height

string

La hauteur.

  • Unité : px.

  • Valeur par défaut : la hauteur d'origine de la vidéo.

720

Qscale

string

Le facteur de contrôle de la qualité vidéo.

15

Crop

string

Les paramètres de recadrage vidéo. Deux méthodes sont prises en charge :

  • Détection et recadrage automatiques des bordures noires. Définissez ce paramètre sur border.

  • Recadrage personnalisé. Format du paramètre : largeur:hauteur:gauche:haut. Exemple : 1280:800:0:140.

border

Bitrate

string

Le débit binaire vidéo moyen. Unité : Kbit/s.

428

Maxrate

string

Le débit binaire vidéo de crête. Unité : Kbit/s.

1000

MaxFps

string

La fréquence d'images maximale.

60

Profile

string

Le profil d'encodage. Valeurs valides :

  • baseline : pour les appareils mobiles.

  • main : pour les appareils à résolution standard.

  • high : pour les appareils à haute résolution.

  • Valeur par défaut : high.

high

Crf

string

Le facteur de débit constant (CRF) pour le contrôle du débit binaire et de la qualité. Si Crf est spécifié, le paramètre Bitrate devient invalide. Valeur par défaut : 26.

26

Gop

string

Le nombre maximal d'images entre les images clés. Valeur par défaut : 250.

250

Width

string

La largeur.

  • Unité : px.

  • Valeur par défaut : la largeur d'origine de la vidéo.

1280

Fps

string

La fréquence d'images.

  • Si la fréquence d'images du fichier d'entrée dépasse 60, la valeur 60 est utilisée.

  • Valeur par défaut : la fréquence d'images du fichier d'entrée.

25

Preset

string

Le préréglage de l'algorithme vidéo. Valeur par défaut : medium. Valeurs valides :

  • veryfast : ultra-rapide.

  • fast : rapide.

  • medium : moyen.

  • slow : lent.

  • slower : ultra-lent.

medium

ScanMode

string

Le mode de balayage. Valeurs valides :

  • Not specified : utilise le mode brut du fichier d'entrée.

  • auto : désentrelacement automatique.

  • progressive : balayage progressif.

  • interlaced : balayage entrelacé.

  • Valeur par défaut : vide, ce qui signifie non spécifié.

Meilleure pratique : Bien que le balayage entrelacé consomme moins de données que le balayage progressif, il entraîne une qualité d'image inférieure. Par conséquent, le balayage progressif est largement utilisé dans la production vidéo grand public.

  • Si vous définissez le balayage progressif ou le balayage entrelacé mais que le mode ne correspond pas au mode vidéo d'origine, le transcodage échoue.

  • Définissez le mode vidéo d'origine ou le désentrelacement automatique pour améliorer la compatibilité.

interlaced

ResoPriority

string

La priorité des ressources.

1

TransConfig

object

Les configurations générales de transcodage. Si cette valeur est spécifiée dans les paramètres de la requête, elle remplace le paramètre correspondant dans le modèle de transcodage spécifié.

IsCheckAudioBitrate

string

Indique si le débit binaire audio doit être vérifié. Si le débit binaire audio de sortie est supérieur au débit binaire audio source, le débit binaire audio de sortie est considéré comme égal au débit binaire audio source, et le paramètre de débit binaire audio spécifié ne prend pas effet. La priorité de ce paramètre est inférieure à celle de IsCheckAudioBitrateFail. Valeurs valides :

  • true : vérifie le débit binaire audio.

  • false : ne vérifie pas le débit binaire audio.

  • Valeur par défaut :
    • Si ce paramètre est vide et que le codec est différent de celui de la source d'entrée : false.

    • Si ce paramètre est vide et que le codec est identique à celui de la source d'entrée : true.

false

TransMode

string

Le mode de transcodage. Valeurs valides : onepass, twopass et CBR. Valeur par défaut : onepass.

onepass

IsCheckReso

string

Indique si la résolution doit être vérifiée. Si la résolution de sortie est supérieure à la résolution d'entrée en largeur ou en hauteur, la résolution de sortie est ajustée à la résolution d'entrée. Valeurs valides :

  • true : vérifie la résolution.

  • false : ne vérifie pas la résolution.

  • Valeur par défaut : false.

false

IsCheckVideoBitrateFail

string

Indique si le débit binaire doit être vérifié. Si le débit binaire vidéo de sortie est supérieur au débit binaire vidéo source, le transcodage n'est pas effectué et un échec de transcodage est renvoyé. La priorité de ce paramètre est supérieure à celle de IsCheckVideoBitrate. Valeurs valides :

  • true : vérifie le débit binaire.

  • false : ne vérifie pas le débit binaire.

  • Valeur par défaut : false.

false

AdjDarMethod

string

La méthode d'ajustement de la résolution. Valeur par défaut : none. Valeurs valides : rescale, crop, pad et none.

none

IsCheckVideoBitrate

string

Indique si le débit binaire vidéo doit être vérifié. Si le débit binaire vidéo de sortie est supérieur au débit binaire vidéo d'entrée, le débit binaire vidéo de sortie est considéré comme égal au débit binaire vidéo d'entrée. Valeurs valides :

  • true : vérifie le débit binaire vidéo.

  • false : ne vérifie pas le débit binaire vidéo.

  • Valeur par défaut : false.

false

IsCheckResoFail

string

Indique si la résolution doit être vérifiée. Si la résolution de sortie est supérieure à la résolution d'entrée en largeur ou en hauteur, un échec de transcodage est renvoyé. Valeurs valides :

  • true : vérifie la résolution.

  • false : ne vérifie pas la résolution.

  • Valeur par défaut : false.

false

IsCheckAudioBitrateFail

string

Indique si le débit binaire audio doit être vérifié. Si le débit binaire audio de sortie est supérieur au débit binaire audio source, le transcodage n'est pas effectué et un échec de transcodage est renvoyé. La priorité de ce paramètre est supérieure à celle de IsCheckAudioBitrate. Valeurs valides :

  • false : vérifie le débit binaire audio.

  • true : ne vérifie pas le débit binaire audio.

false

Encryption

object

Les paramètres de chiffrement des données. Seule la sortie au format M3U8 est prise en charge.

Type

string

Le type de chiffrement. Valeur valide : hls-aes-128.

hls-aes-128

Key

string

La clé utilisée pour chiffrer la vidéo.

encryptionkey128

KeyType

string

La méthode de chiffrement de la clé secrète. Valeurs valides : Base64 et KMS.

Remarque

Si la clé est "encryptionkey128", la valeur est Base64("encryptionkey128") ou KMS(Base64("encryptionkey128")).

Base64

Id

string

L'identifiant de chiffrement.

31fa3c9ca8134f9cec2b4b0b0f78****

KeyUri

string

L'URL utilisée pour accéder à la clé. L'URL est encodée en Base64.

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

SkipCnt

string

Le nombre de segments non chiffrés au début de la vidéo. Cela permet à la vidéo de démarrer rapidement.

3

WaterMarkList

object

WaterMark

array<object>

La liste des filigranes.

array<object>

Les détails du filigrane.

Type

string

Le type de filigrane. Si ce paramètre est spécifié dans les paramètres de la requête, il remplace le paramètre correspondant dans le modèle de filigrane. Pour plus d'informations, consultez Détails des paramètres. Valeurs valides :

  • Image : filigrane d'image.

  • Text : filigrane de texte.

Image

ReferPos

string

La position du filigrane. Valeurs valides :

  • TopRight : en haut à droite.

  • TopLeft : en haut à gauche.

  • BottomRight : en bas à droite.

  • BottomLeft : en bas à gauche.

TopRight

Dx

string

Le décalage horizontal de l'image du filigrane par rapport à la vidéo de sortie. Si ce paramètre est spécifié dans les paramètres de la requête, il remplace le paramètre correspondant dans le modèle de filigrane. Valeur par défaut : 0. La valeur peut être dans l'un des formats suivants :

  • Entier : représente le décalage en pixels.

    • Valeurs valides : [8, 4096].

    • Unité : px.

  • Décimal : représente le rapport entre le décalage horizontal et la largeur de la résolution de sortie.

    • Valeurs valides : (0, 1).

    • Jusqu'à quatre décimales sont prises en charge. Par exemple, 0.9999. Les décimales supplémentaires sont automatiquement ignorées.

100

Width

string

La largeur de l'image du filigrane. Si ce paramètre est spécifié dans les paramètres de la requête, il remplace le paramètre correspondant dans le modèle de filigrane. La valeur peut être dans l'un des formats suivants :

  • Entier : représente la largeur de l'image du filigrane en pixels.

    • Valeurs valides : [8, 4096].

    • Unité : px.

  • Décimal : représente le rapport entre la largeur de l'image du filigrane et la largeur de la résolution vidéo de sortie.

    • Valeurs valides : (0, 1).

    • Jusqu'à quatre décimales sont prises en charge. Par exemple, 0.9999. Les décimales supplémentaires sont automatiquement ignorées.

50

Height

string

La hauteur de l'image du filigrane. Si ce paramètre est spécifié dans les paramètres de la requête, il remplace le paramètre correspondant dans le modèle de filigrane. La valeur peut être dans l'un des formats suivants :

  • Entier : représente la hauteur de l'image du filigrane en pixels.

    • Valeurs valides : [8, 4096].

    • Unité : px.

  • Décimal : représente le rapport entre la hauteur de l'image du filigrane et la hauteur de la résolution vidéo de sortie.

    • Valeurs valides : (0, 1).

    • Jusqu'à quatre décimales sont prises en charge. Par exemple, 0.9999. Les décimales supplémentaires sont automatiquement ignorées.

50

InputFile

object

Le fichier d'entrée pour le filigrane.

Object

string

L'objet OSS du fichier d'entrée.

example-logo-****.png

Location

string

L'emplacement OSS du fichier d'entrée.

oss-cn-hangzhou

Bucket

string

Le compartiment OSS du fichier d'entrée.

example-bucket

WaterMarkTemplateId

string

L'identifiant du modèle de filigrane.

88c6ca184c0e47098a5b665e2a12****

Dy

string

Le décalage vertical de l'image du filigrane par rapport à la vidéo de sortie. Si ce paramètre est spécifié dans les paramètres de la requête, il remplace le paramètre correspondant dans le modèle de filigrane. La valeur peut être dans l'un des formats suivants :

  • Entier : représente le décalage vertical de l'image du filigrane par rapport à la vidéo de sortie en pixels.

    • Valeurs valides : [8, 4096].

    • Unité : px.

  • Décimal : représente le rapport entre le décalage vertical de l'image du filigrane et la vidéo de sortie.

    • Valeurs valides : (0, 1).

    • Jusqu'à quatre décimales sont prises en charge. Par exemple, 0.9999. Les décimales supplémentaires sont automatiquement ignorées.

100

WaterMarkConfigUrl

string

L'URL du fichier de configuration du filigrane.

http://example.com/configure

DeWatermark

string

Les paramètres de floutage. Il s'agit d'un objet JSON. Pour plus d'informations, consultez les détails du floutage dans Détails des paramètres.

{"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

Les paramètres de prise en charge M3U8 non standard. Il s'agit d'un objet JSON. Pour plus d'informations, consultez les détails de la prise en charge des paramètres M3U8 non standard dans Détails des paramètres.

TS

object

Les paramètres de prise en charge des fichiers TS non standard. Il s'agit d'un objet JSON. Pour plus d'informations, consultez les détails de la prise en charge des paramètres TS dans Détails des paramètres.

SizeSupport

boolean

Indique si la taille du fichier TS doit être sortie dans le fichier M3U8. Valeurs valides :

  • true : pris en charge.

  • false : non pris en charge.

true

Md5Support

boolean

Indique si la valeur de hachage MD5 du fichier TS doit être sortie dans le fichier M3U8. Valeurs valides :

  • true : pris en charge.

  • false : non pris en charge.

true

Priority

string

La priorité du travail dans sa file d'attente MPS correspondante.

  • Priorité la plus élevée : 10.

  • Valeur par défaut : 6.

6

Audio

object

Les configurations audio.

Profile

string

Le préréglage d'encodage audio. Lorsque Codec est défini sur aac, les valeurs valides sont aaclow, aache, aachev2, aacld et aaceld.

aaclow

Codec

string

Le format d'encodage audio. Valeurs valides : aac, mp3, vorbis et flac. Valeur par défaut : aac.

aac

Samplerate

string

La fréquence d'échantillonnage. Valeurs valides : 22050, 32000, 44100, 48000 et 96000. Unité : Hz. Valeur par défaut : 44100. Si le format de conteneur vidéo est FLV et que le format d'encodage audio est MP3, les fréquences d'échantillonnage 32000, 48000 et 96000 ne sont pas prises en charge. Si le format d'encodage audio est MP3, la fréquence d'échantillonnage 96000 n'est pas prise en charge.

44100

Qscale

string

Le facteur de contrôle de la qualité audio.

15

Channels

string

Le nombre de canaux audio.

  • Lorsque Codec est défini sur mp3, seuls 1 et 2 sont pris en charge.

  • Lorsque Codec est défini sur aac, seuls 1, 2, 4, 5, 6 et 8 sont pris en charge.

  • Valeur par défaut : 2.

2

Volume

object

Les configurations de volume.

Method

string

La méthode d'ajustement du volume. Valeurs valides :

  • auto : ajustement automatique.

  • dynamic : ajustement dynamique.

  • linear : ajustement linéaire.

auto

Level

string

Le niveau de réglage du volume.

  • Unité : dB.

  • Valeur par défaut : -20 dB.

-20

Bitrate

string

Le débit binaire audio du fichier de sortie.

  • Unité : Kbps.

  • Valeur par défaut : 128.

128

AudioStreamMap

string

L'index du flux audio.

  • Format : 0:a:{index}.

  • L'index commence à 0 et indique l'indice de la liste des flux audio. Si ce paramètre n'est pas défini, le flux audio par défaut est sélectionné.

0:a:0

MergeList

object

Merge

array<object>

La configuration de fusion vidéo.

object

Les détails de la configuration de fusion vidéo.

Start

string

L'heure de début.

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

  • Exemple : 01:59:59.999 ou 32000.23.

01:59:59.999 or 32000.23

RoleArn

string

L'ARN du rôle RAM utilisé pour l'autorisation.

acs:ram:::role/

MergeURL

string

L'URL du clip à fusionner.

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

  • Le nom de l'objet doit être encodé en URL et utiliser l'encodage UTF-8.

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

Duration

string

L'heure de début.

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

  • Exemple : 01:59:59.999 ou 32000.23.

01:59:59.999

SuperReso

object

La configuration d'adaptation à la résolution source.

IsHalfSample

string

Indique si les paramètres liés au taux d'échantillonnage doivent être obtenus. Valeurs valides :

  • true : Oui.

  • false : Non.

true

UserData

string

Les données utilisateur personnalisées.

test-001

OutSubtitleList

object

OutSubtitle

array<object>

La liste des sous-titres de sortie.

array<object>

Les détails des sous-titres de sortie.

Map

string

La piste vidéo. Format : 0:{stream}:{stream_index}, soit 0:v:{video_index}. La valeur du flux est v pour les flux vidéo. L'index indique l'indice de la liste des flux vidéo et commence à 0.

0:v:0

OutSubtitleFile

object

Les détails du fichier de sortie.

RoleArn

string

L'ARN du rôle RAM utilisé pour l'autorisation.

acs:ram:::role/

Object

string

L'objet OSS du fichier de sortie.

example-output.flv

Location

string

L'emplacement OSS du fichier de sortie.

oss-cn-hangzhou

Bucket

string

Le compartiment OSS du fichier d'entrée.

example-bucket-****

Success

boolean

Indique si l'opération a réussi. Valeurs valides :

  • true : Succès.

  • false : Échec.

true

Message

string

Le message d'erreur renvoyé lorsque la création de la tâche échoue. Ce paramètre n'est pas renvoyé si la tâche est créée.

The specified parameter “%s” cannot be null.

VideoStreamMap

string

L'index du flux vidéo.

  • Format : 0:v:{index}. Exemple : 0:v:0.

  • L'index commence à 0 et indique l'indice de la liste des flux vidéo.

  • Si ce paramètre n'est pas défini, le flux vidéo par défaut est sélectionné.

0:a:0

OutputFile

object

Le fichier de sortie.

RoleArn

string

L'ARN du rôle RAM utilisé pour l'autorisation.

acs:ram:::role/

Object

string

L'objet OSS du fichier de sortie.

example-output.flv

Location

string

L'emplacement OSS du fichier de sortie.

oss-cn-hangzhou

Bucket

string

Le compartiment OSS du fichier d'entrée.

example-bucket

Rotate

string

L'angle de rotation de la vidéo.

90

Container

object

Le conteneur.

Format

string

Le format du conteneur.

  • Valeur par défaut : mp4.

  • Valeurs valides pour le transcodage vidéo : flv, mp4, HLS (m3u8+ts) et MPEG-DASH (MPD+fMP4).

  • Valeurs valides pour le transcodage audio : mp3, mp4, ogg, flac et m4a.

  • Valeurs valides pour les images : gif et WEBP.

  • Si le format du conteneur est gif, le paramètre VideoCodec doit être défini sur GIF.

  • Si le format du conteneur est webp, le paramètre VideoCodec doit être défini sur WEBP.

  • Si le format du conteneur est flv, le paramètre VideoCodec ne peut pas être défini sur H265.

flv

Clip

object

Le clip.

TimeSpan

object

L'intervalle de temps du clip.

Seek

string

L'heure de début.

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

  • Valeurs valides : [00:00:00.000,23:59:59.999] ou [0.000,86399.999].

  • Exemple : 01:59:59.999 ou 32000.23.

01:00:59.999

Duration

string

La durée.

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

  • Valeurs valides : [00:00:00.000,23:59:59.999] ou [0.000,86399.999].

  • Exemple : 01:00:59.999 ou 32000.23.

01:00:59.999

MergeConfigUrl

string

L'URL du fichier de configuration de fusion. Vous ne pouvez spécifier qu'un seul des paramètres MergeList et MergeConfigUrl.

  • Le fichier de configuration spécifié par MergeConfigUrl prend en charge un maximum de 50 clips fusionnés.

  • MergeConfigUrl spécifie l'URL du fichier de configuration de fusion.

  • Seuls les fichiers de configuration stockés dans OSS sont pris en charge, et vous devez vous assurer que les autorisations d'accès sont accordées à MPS. Pour le contenu interne du fichier, reportez-vous aux détails des paramètres de fusion.

  • Exemple de contenu interne du fichier mergeConfigfile : {"MergeList":[{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4"}]}.

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

OpeningList

object

Opening

array<object>

La liste des ardoises d'ouverture.

object

Les détails des ardoises d'ouverture.

openUrl

string

L'URL OSS de la vidéo d'ouverture.

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

Start

string

L'heure de début par rapport à la vidéo principale. La vidéo d'ouverture est affichée après un délai commençant à 0.

  • Unité : secondes.

  • Valeur par défaut : 0.

0

Width

string

La largeur. Valeurs valides : (0,4096), -1 et full.

  • Valeur par défaut : -1.

  • -1 indique la valeur de la vidéo source.

  • full indique le remplissage de tout l'écran.

-1

Height

string

La hauteur. Valeurs valides : (0,4096), -1 et full.

  • Valeur par défaut : -1.

  • -1 indique la valeur de la vidéo source.

  • full indique le remplissage de tout l'écran.

-1

MuxConfig

object

La configuration de multiplexage.

Webp

object

La configuration de multiplexage pour WebP.

Loop

string

Le nombre de boucles.

0

Gif

object

La configuration de multiplexage pour GIF.

FinalDelay

string

Le temps de pause de la dernière image. Unité : centisecondes.

0

DitherMode

string

Le mode de tramage des couleurs de la palette. Valeurs valides : sierra et bayer.

bayer

Loop

string

Le nombre de boucles.

0

IsCustomPalette

string

Indique si une palette personnalisée doit être utilisée. Valeurs valides :

  • true : Palette personnalisée.

  • false : Palette par défaut.

true

Segment

object

La configuration des segments. Il s'agit d'un objet JSON.

Duration

string

La durée du segment. Il s'agit d'un entier. Unité : secondes.

  • Valeurs valides : [1,10].

  • Valeur par défaut : 10.

10

TailSlateList

object

TailSlate

array<object>

La liste des ardoises de fin.

object

Les détails des ardoises de fin.

Start

string

L'heure de début.

1

BgColor

string

La couleur d'arrière-plan utilisée pour remplir l'espace vide lorsque la largeur et la hauteur de la vidéo de l'ardoise de fin sont inférieures à celles de la vidéo principale. Valeur par défaut : White. Pour plus d'informations, consultez bgcolor.

White

IsMergeAudio

boolean

Indique si le contenu audio de la vidéo de l'ardoise de fin doit être fusionné. Valeurs valides :

  • true : Oui.

  • false : Non.

true

Width

string

La largeur. Valeurs valides : (0,4096), -1 et full.

  • -1 indique la valeur de la vidéo source. full indique le remplissage de tout l'écran.

  • Valeur par défaut : -1.

-1

Height

string

La hauteur. Valeurs valides : (0,4096), -1 et full.

  • -1 indique la valeur de la vidéo source.

  • full indique le remplissage de tout l'écran.

  • Valeur par défaut : -1.

-1

BlendDuration

string

La durée de la transition entre la vidéo principale et la vidéo de l'ardoise de fin. L'effet de transition est un fondu enchaîné : la vidéo principale affiche sa dernière image tandis que la vidéo de l'ardoise de fin commence à être lue. La dernière image de la vidéo principale s'assombrit progressivement, et la vidéo de l'ardoise de fin s'éclaircit progressivement. Unité : secondes. Valeur par défaut : 0.

0

TailUrl

string

L'URL OSS de la vidéo de l'ardoise de fin.

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

TemplateId

string

L'identifiant du modèle.

S00000000-000010

SubtitleConfig

object

La configuration des sous-titres.

ExtSubtitleList

object

ExtSubtitle

array<object>

La liste des sous-titres externes. Il s'agit d'un tableau JSON.

array<object>

Les détails des sous-titres.

CharEnc

string

L'encodage des caractères des sous-titres externes.

  • Valeurs valides : UTF-8, GBK, BIG5 et auto.

  • Valeur par défaut : auto.

Remarque

Lorsque l'encodage des caractères des sous-titres externes est défini sur auto, une fausse détection peut se produire. Spécifiez un encodage de caractères spécifique.

auto

FontName

string

Le nom de la police utilisée lorsque les sous-titres externes sont convertis en sous-titres incrustés.

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

Input

object

Le fichier de sous-titres d'entrée externe.

  • Actuellement, les formats srt et ass sont pris en charge. Pour plus d'informations, consultez le paramètre Input dans Détails des paramètres.

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

Object

string

L'objet OSS du fichier d'entrée.

example-output.flv

Location

string

L'emplacement OSS du fichier d'entrée.

oss-cn-hangzhou

Bucket

string

Le compartiment OSS du fichier d'entrée.

example-bucket-****

SubtitleList

object

Subtitle

array<object>

Les sous-titres.

object

Map

string

Le numéro de séquence du flux vidéo. Le numéro de séquence est l'index du flux vidéo dans la liste et commence à 0. Si vous ne définissez pas le paramètre correspondant dans la requête, le flux vidéo par défaut est sélectionné.

0

Properties

object

Les propriétés du média.

Width

string

La largeur de la vidéo.

720

Height

string

La hauteur de la vidéo.

1280

Duration

string

La durée.

17

Fps

string

La fréquence d'images.

30

Bitrate

string

Le débit binaire.

490

FileFormat

string

Le format de fichier.

mp4

Streams

object

Les informations de flux.

VideoStreamList

object

VideoStream

array<object>

La liste des flux vidéo.

array<object>

Les détails du flux vidéo.

Index

string

L'index du flux vidéo, qui indique la position du flux vidéo parmi tous les flux multimédias.

0

Timebase

string

La base de temps.

1/15360

AvgFPS

string

La fréquence d'images moyenne.

30.0

PixFmt

string

Le format de pixel.

yuv420p

Sar

string

Le rapport d'aspect des échantillons.

1:1

Lang

string

La langue. Pour plus d'informations, consultez les définitions de langue FFmpeg et ISO-639.

und

CodecLongName

string

Le nom long du format d'encodage.

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

Height

string

La hauteur de la vidéo.

1280

NumFrames

string

Le nombre total d'images.

30

Bitrate

string

Le débit binaire.

421.117

CodecTagString

string

Le texte de la marque du format d'encodage.

avc1

HasBFrames

string

Indique si le flux vidéo contient des images B.

2

Profile

string

Le profil du codec.

high

StartTime

string

L'heure de début.

0.000000

NetworkCost

object

La consommation de bande passante réseau.

PreloadTime

string

Le temps consommé pour précharger le flux vidéo.

8

AvgBitrate

string

Le débit binaire moyen du flux vidéo.

300

CostBandwidth

string

La bande passante maximale consommée.

10

Dar

string

Le rapport d'aspect d'affichage.

9:16

CodecName

string

Le nom court du format d'encodage.

h264

Width

string

La largeur de la vidéo.

720

Duration

string

La durée.

17.233333

Fps

string

La fréquence d'images.

30.0

CodecTag

string

La marque du format d'encodage.

0x31637661

CodecTimeBase

string

La base de temps du codec.

1/60

Level

string

Le niveau d'encodage.

31

AudioStreamList

object

AudioStream

array<object>

La liste des flux audio.

object

Les détails du flux audio.

Timebase

string

La base de temps.

1/32000

Index

string

L'index du flux audio, qui indique la position du flux audio parmi tous les flux multimédias.

1

SampleFmt

string

Le format d'échantillon.

fltp

ChannelLayout

string

La disposition des canaux.

mono

Lang

string

La langue. Pour plus d'informations, consultez les définitions de langue FFmpeg et ISO-639.

und

Samplerate

string

La fréquence d'échantillonnage.

32000

CodecLongName

string

Le nom long du format d'encodage.

AAC (Advanced Audio Coding)

Channels

string

Le nombre de canaux.

1

NumFrames

string

Le nombre total d'images.

30

Bitrate

string

Le débit binaire.

64.136

CodecTagString

string

Le texte de la marque du format d'encodage.

mp4a

StartTime

string

L'heure de début.

0.000000

CodecName

string

Le nom court du format d'encodage.

aac

Duration

string

La durée.

17.223562

CodecTag

string

La marque du format d'encodage.

0x6134706d

CodecTimeBase

string

La base de temps du codec.

1/32000

SubtitleStreamList

object

SubtitleStream

array<object>

La liste des flux de sous-titres.

object

Les détails du flux de sous-titres.

Index

string

L'index du flux de sous-titres, qui indique la position du flux de sous-titres parmi tous les flux multimédias.

1

Lang

string

La langue.

und

Format

object

Les informations de format.

StartTime

string

L'heure de début.

0.064000

NumPrograms

string

Le nombre total de flux de programme.

0

Size

string

La taille du fichier.

1057273

NumStreams

string

Le nombre total de flux multimédias.

2

FormatLongName

string

Le nom long du format de conteneur.

QuickTime / MOV

Duration

string

La durée totale.

17.234000

Bitrate

string

Le débit binaire total.

490.784

FormatName

string

Le nom court du format de conteneur. Valeurs valides : mov, mp4, m4a, 3gp, 3g2 et mj2.

mov

FileSize

string

La taille du fichier.

1057273

PipelineId

string

L'identifiant de la file d'attente MPS.

88c6ca184c0e47b665e2a1267971****

Input

object

L'entrée de la tâche.

Object

string

L'objet OSS de l'entrée de la tâche.

example.flv

Location

string

L'emplacement OSS de l'entrée de la tâche.

oss-cn-hangzhou

Bucket

string

Le compartiment OSS de l'entrée de la tâche.

example-bucket

MNSMessageResult

object

Le résultat du message MNS envoyé pour notifier à l'utilisateur que la tâche est terminée.

MessageId

string

L'identifiant du message renvoyé lorsque la notification réussit.

123

ErrorMessage

string

Le message d'erreur renvoyé lorsque la notification échoue. Ce paramètre n'est pas renvoyé lorsque la notification réussit.

The resource operated “%s” cannot be found.

ErrorCode

string

Le code d'erreur renvoyé lorsque la notification échoue. Ce paramètre n'est pas renvoyé lorsque la notification réussit.

InvalidParameter.ResourceNotFound

Exemples

JSON format

{
  "RequestId": "BC860F04-778A-472F-AB39-E1BF329C1EA8",
  "NextPageToken": "16f01ad6175e4230ac42bb5182cd****",
  "JobList": {
    "Job": [
      {
        "CreationTime": "2014-01-10T12:00:00Z",
        "Percent": 100,
        "FinishTime": "2014-01-10T12:20:25Z",
        "State": "TranscodeSuccess",
        "JobId": "31fa3c9ca8134fb4b0b0f7878301****",
        "Code": "InternalError",
        "Message": "The operation has failed due to some unknown error, exception or failure",
        "Output": {
          "Video": {
            "Bufsize": "6000",
            "Degrain": "5",
            "BitrateBnd": {
              "Max": "1000",
              "Min": "200"
            },
            "PixFmt": "yuv420p",
            "Pad": "1280:800:0:140",
            "Codec": "H.264",
            "Height": "720",
            "Qscale": "15",
            "Crop": "border",
            "Bitrate": "428",
            "Maxrate": "1000",
            "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 ou 32000.23",
                "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": "test-001",
          "OutSubtitleList": {
            "OutSubtitle": [
              {
                "Map": "0:v:0",
                "OutSubtitleFile": {
                  "RoleArn": "acs:ram:::role/",
                  "Object": "example-output.flv",
                  "Location": "oss-cn-hangzhou",
                  "Bucket": "example-bucket-****"
                },
                "Success": true,
                "Message": "Le paramètre spécifié « %s » ne peut pas être null"
              }
            ]
          },
          "VideoStreamMap": "0:a:0",
          "OutputFile": {
            "RoleArn": "acs:ram:::role/",
            "Object": "example-output.flv",
            "Location": "oss-cn-hangzhou",
            "Bucket": "example-bucket"
          },
          "Rotate": "90",
          "Container": {
            "Format": "flv"
          },
          "Clip": {
            "TimeSpan": {
              "Seek": "01:00:59.999",
              "Duration": "01:00:59.999"
            }
          },
          "MergeConfigUrl": "{\"MergeList\":[{\"MergeURL\":\"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4\"}]}",
          "OpeningList": {
            "Opening": [
              {
                "openUrl": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv",
                "Start": "0",
                "Width": "-1",
                "Height": "-1"
              }
            ]
          },
          "MuxConfig": {
            "Webp": {
              "Loop": "0"
            },
            "Gif": {
              "FinalDelay": "0",
              "DitherMode": "bayer",
              "Loop": "0",
              "IsCustomPalette": "true"
            },
            "Segment": {
              "Duration": "10"
            }
          },
          "TailSlateList": {
            "TailSlate": [
              {
                "Start": "1",
                "BgColor": "White",
                "IsMergeAudio": true,
                "Width": "-1",
                "Height": "-1",
                "BlendDuration": "0",
                "TailUrl": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv"
              }
            ]
          },
          "TemplateId": "S00000000-000010",
          "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"
                }
              ]
            }
          },
          "Properties": {
            "Width": "720",
            "Height": "1280",
            "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": "und",
                    "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"
                  }
                ]
              },
              "AudioStreamList": {
                "AudioStream": [
                  {
                    "Timebase": "1/32000",
                    "Index": "1",
                    "SampleFmt": "fltp",
                    "ChannelLayout": "mono",
                    "Lang": "und",
                    "Samplerate": "32000",
                    "CodecLongName": "AAC (Advanced Audio Coding)",
                    "Channels": "1",
                    "NumFrames": "30",
                    "Bitrate": "64.136",
                    "CodecTagString": "mp4a",
                    "StartTime": "0.000000",
                    "CodecName": "aac",
                    "Duration": "17.223562",
                    "CodecTag": "0x6134706d",
                    "CodecTimeBase": "1/32000"
                  }
                ]
              },
              "SubtitleStreamList": {
                "SubtitleStream": [
                  {
                    "Index": "1",
                    "Lang": "und"
                  }
                ]
              }
            },
            "Format": {
              "StartTime": "0.064000",
              "NumPrograms": "0",
              "Size": "1057273",
              "NumStreams": "2",
              "FormatLongName": "QuickTime / MOV",
              "Duration": "17.234000",
              "Bitrate": "490.784",
              "FormatName": "mov"
            },
            "FileSize": "1057273"
          }
        },
        "PipelineId": "88c6ca184c0e47b665e2a1267971****",
        "Input": {
          "Object": "example.flv",
          "Location": "oss-cn-hangzhou",
          "Bucket": "example-bucket"
        },
        "MNSMessageResult": {
          "MessageId": "123",
          "ErrorMessage": "La ressource concernée par l'opération « %s » est introuvable",
          "ErrorCode": "InvalidParameter.ResourceNotFound"
        }
      }
    ]
  }
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.