Soumet une tâche de transcodage. Lorsque les tâches de transcodage et les flux de travail créés dans la console ne répondent pas à vos besoins, vous pouvez appeler l'opération SubmitJobs pour transcoder des fichiers multimédias selon vos besoins. Configurez les paramètres de transcodage requis en fonction de votre logique métier.
Description de l'opération
-
Les tâches de transcodage sont des tâches asynchrones et le traitement en temps réel n'est pas garanti. Après avoir soumis une tâche de transcodage, la tâche est ajoutée à une file d'attente MPS pour planification et exécution. Par conséquent, le transcodage peut ne pas être terminé lorsque l'API renvoie une réponse. Une fois l'exécution terminée, vous devez appeler l'opération interroger les tâches de transcodage pour récupérer les résultats d'exécution, ou lier une file d'attente MNS à la file d'attente MPS pour recevoir les résultats d'exécution. Pour plus d'informations, consultez Recevoir des notifications de messages.
-
La taille maximale d'un seul fichier d'entrée est de 100 Go. Le dépassement de cette limite peut entraîner l'échec de la tâche.
-
Pour transcoder un fichier d'entrée à l'aide d'un modèle intelligent prédéfini, vous devez d'abord appeler l'opération SubmitAnalysisJob pour soumettre une tâche d'analyse de modèle prédéfini. Une fois la tâche d'analyse terminée, vous pouvez appeler l'opération QueryAnalysisJobList pour obtenir la liste des modèles prédéfinis disponibles pour le fichier d'entrée. Lorsque vous soumettez une tâche de transcodage, le paramètre TemplateId doit être défini sur l'identifiant d'un modèle prédéfini disponible. Si le modèle spécifié dans la tâche de transcodage soumise ne figure pas dans la liste des modèles prédéfinis disponibles, la tâche de transcodage échoue.
-
Pour transcoder un fichier d'entrée à l'aide d'un modèle statique prédéfini, vous n'avez pas besoin de soumettre de tâche d'analyse de modèle.
-
Pour utiliser plusieurs comptes dans ApsaraVideo Media Processing, vous pouvez créer des utilisateurs Resource Access Management (RAM) pour votre compte Alibaba Cloud. Pour plus d'informations, consultez Créer un utilisateur RAM et lui accorder des autorisations. Si vous utilisez différents comptes Alibaba Cloud pour soumettre et interroger des tâches de transcodage, vous ne pourrez pas interroger les données des tâches.
-
Pour plus de questions fréquemment posées sur le transcodage, consultez la FAQ d'ApsaraVideo Media Processing.
Limite de QPS
La limite de QPS pour un seul utilisateur est de 100 requêtes par seconde. Si cette limite est dépassée, les appels d'API sont limités, ce qui peut affecter votre activité. Effectuez les appels d'API à un rythme 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
|
mts:SubmitJobs |
create |
*Toutes les ressources.
|
Aucune | Aucune |
Paramètres de requête
|
Paramètre |
Type |
Requis |
Description |
Exemple |
| Input |
string |
Oui |
L'entrée de la tâche. Pour plus d'informations, consultez Entrée. Remarque
|
{"Bucket":"exampleBucket","Location":"oss-cn-hangzhou","Object":"example.flv","Referer": "The hotlink protection parameter configured by the user in the OSS console"} |
| Outputs |
string |
Oui |
Les configurations de sortie de la tâche. Pour plus d'informations, consultez Sortie.
|
[{"OutputObject":"exampleOutput.mp4","TemplateId":"6181666213ab41b9bc21da8ff5ff****","WaterMarks":[{"InputFile":{"Bucket":"exampleBucket","Location":"oss-cn-hangzhou","Object":"image_01.png"},"WaterMarkTemplateId":"9b772ce2740d4d55876d8b542d47****"}],"UserData":"testid-001"}] |
| OutputBucket |
string |
Oui |
Le compartiment OSS où le fichier de sortie est stocké.
|
exampleBucket |
| OutputLocation |
string |
Non |
La région du compartiment OSS où le fichier de sortie est stocké.
|
oss-cn-hangzhou |
| PipelineId |
string |
Oui |
L'identifiant de la file d'attente MPS. Pour plus d'informations, consultez Termes.
|
dd3dae411e704030b921e52698e5**** |
Éléments de réponse
|
Élément |
Type |
Description |
Exemple |
|
object |
Les paramètres de réponse. |
||
| JobResultList |
object |
||
| JobResult |
array<object> |
La liste des résultats des travaux de transcodage soumis. |
|
|
array<object> |
Les paramètres de réponse. |
||
| Code |
string |
Le code d'erreur renvoyé lorsque la création du travail échoue. Ce paramètre n'est pas renvoyé si le travail est créé. |
InvalidParameter.NullValue |
| Job |
object |
Informations détaillées sur le travail. Aucun identifiant de travail n'est généré en cas d'échec de la soumission du travail. |
|
| Code |
string |
Code d'erreur en cas d'échec du transcodage. Ce paramètre n'est pas renvoyé si le transcodage réussit. |
InternalError |
| CreationTime |
string |
Heure à laquelle le travail a été ajouté. |
2014-01-10T12:00:00Z |
| FinishTime |
string |
Heure à laquelle le travail s'est terminé. |
2014-01-10T12:20:00Z |
| Input |
object |
Entrée du travail. |
|
| Bucket |
string |
Compartiment OSS pour l'entrée du travail. |
example-bucket-**** |
| Location |
string |
Emplacement OSS pour l'entrée du travail. |
oss-cn-hangzhou |
| Object |
string |
Objet OSS pour l'entrée du travail. |
example.flv |
| JobId |
string |
Identifiant du travail. |
31fa3c9ca8134f9cec2b4b0b0f78**** |
| MNSMessageResult |
object |
Résultat de la notification MNS pour l'achèvement du travail. |
|
| ErrorCode |
string |
Code d'erreur en cas d'échec de la notification. Ce paramètre n'est pas renvoyé si la notification réussit. |
InvalidParameter.ResourceNotFound |
| ErrorMessage |
string |
Message d'erreur en cas d'échec de la notification. Ce paramètre n'est pas renvoyé si la notification réussit. |
The resource operated "%s" cannot be found |
| MessageId |
string |
Identifiant du message d'erreur en cas d'échec de la notification. Ce paramètre n'est pas renvoyé si la notification réussit. |
123 |
| Message |
string |
Message en cas d'échec du transcodage. Ce paramètre n'est pas renvoyé si le transcodage réussit. |
The operation has failed due to some unknown error, exception or failure |
| Output |
object |
Sortie du travail. |
|
| AmixList |
object |
||
| Amix |
array<object> |
Liste de mixage audio. |
|
|
object |
Paramètres de réponse. |
||
| AmixURL |
string |
Fichier multimédia à mixer en tant qu'audio d'arrière-plan.
|
https://outpu***.oss-cn-shanghai.aliyuncs.com/mp4-to-mp3%5E1571025263578816%40.mp3 |
| Duration |
string |
Durée. Format : numérique ou format d'heure. |
20 |
| Map |
string |
Sélectionnez la piste audio cible à partir de AmixURL. Valeurs valides : 0:a:{audio_index}, par exemple 0:a:0. |
0:a:0 |
| MixDurMode |
string |
Sélection de la durée du média. Valeurs valides : first, long.
|
long |
| Start |
string |
Heure de début. Format : numérique ou format d'heure, par exemple « 1:25:36.240 » ou « 32000.23 ». |
0 |
| Audio |
object |
Configuration audio. Remarque
Si vous spécifiez la configuration audio dans les paramètres de la requête, elle remplace les paramètres correspondants dans le modèle de transcodage spécifié. |
|
| Bitrate |
string |
Débit binaire audio du fichier de sortie. |
128 |
| Channels |
string |
Nombre de canaux audio.
|
6 |
| Codec |
string |
Format du codec audio.
|
aac |
| Profile |
string |
Profil du codec audio. Remarque
Lorsque Codec est aac, les valeurs valides incluent aac_low, aac_he, aac_he_v2, aac_ld et aac_eld. |
aac_low |
| Qscale |
string |
Facteur de contrôle de la qualité audio. |
15 |
| Samplerate |
string |
Fréquence d'échantillonnage.
Remarque
Si le format de conteneur est flv et que le codec audio est mp3, les fréquences d'échantillonnage 32000, 48000 et 96000 ne sont pas prises en charge. Si le codec audio est mp3, la fréquence d'échantillonnage 96000 n'est pas prise en charge. |
32000 |
| Volume |
object |
Contrôle du volume. |
|
| Level |
string |
Niveau de réglage du volume. |
-20 |
| Method |
string |
Méthode d'ajustement du volume. Valeurs valides :
|
auto |
| AudioStreamMap |
string |
Index du flux audio.
|
0:a:0 |
| Clip |
object |
Segment de découpage. |
|
| TimeSpan |
object |
Plage de temps de découpage. |
|
| Duration |
string |
Durée.
|
01:00:59.999 |
| Seek |
string |
Heure de début.
|
01:59:59.999 |
| Container |
object |
Conteneur. |
|
| Format |
string |
Format du conteneur.
|
flv |
| DeWatermark |
string |
Traitement de floutage, sous forme d'objet JSON. Pour plus d'informations, consultez Détails du traitement de 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}]} |
| DigiWaterMark |
object |
Filigrane numérique. |
|
| Alpha |
string |
Transparence du texte ou de l'image.
|
1.0 |
| InputFile |
object |
Fichier d'entrée. |
|
| Bucket |
string |
Compartiment OSS pour le fichier d'entrée. |
example-bucket-**** |
| Location |
string |
Emplacement OSS pour le fichier d'entrée. |
oss-cn-hangzhou |
| Object |
string |
Objet OSS pour le fichier d'entrée. |
example-intput.flv |
| Type |
string |
Type de filigrane. Si elle est définie, cette valeur remplace le paramètre correspondant dans le modèle de filigrane. Valeurs valides :
|
Image |
| Encryption |
object |
Chiffrement des données. Pris en charge uniquement pour la sortie m3u8. |
|
| Id |
string |
Identifiant de chiffrement. |
31fa3c9ca8134f9cec2b4b0b0f78**** |
| Key |
string |
Clé de chiffrement pour la vidéo. |
encryptionkey128 |
| KeyType |
string |
La clé de chiffrement ne peut pas être envoyée en texte clair à MPS. Elle doit être chiffrée à l'aide de Base64 ou KMS. Par exemple, si la clé est « encryptionkey128 », utilisez Base64("encryptionkey128") ou KMS(Base64("encryptionkey128")). |
Base64 |
| KeyUri |
string |
URL pour accéder à la clé, encodée en BASE64. |
https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/ |
| SkipCnt |
string |
Nombre de segments initiaux pour lesquels le chiffrement est ignoré (pour permettre une lecture rapide). |
3 |
| Type |
string |
Type de chiffrement. Valeur valide : hls-aes-128. |
hls-aes-128 |
| M3U8NonStandardSupport |
object |
Prise en charge non standard M3U8, sous forme d'objet JSON. Pour plus d'informations, consultez Détails de la prise en charge des paramètres non standard M3U8 dans Détails des paramètres. |
|
| TS |
object |
Objet JSON pour la prise en charge non standard des fichiers TS. Pour plus d'informations, consultez Détails de la prise en charge des paramètres TS dans Détails des paramètres. |
|
| Md5Support |
boolean |
Indique si la valeur MD5 des fichiers TS du fichier M3U8 doit être générée en sortie. Valeurs valides :
|
true |
| SizeSupport |
boolean |
Indique si la taille des fichiers TS dans le fichier M3U8 doit être incluse en sortie. Valeurs valides :
|
true |
| MergeConfigUrl |
string |
Vous pouvez spécifier soit MergeList, soit MergeConfigUrl, mais pas les deux.
|
`{"MergeList":[{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4"}]}` |
| MergeList |
object |
||
| Merge |
array<object> |
Configuration de la fusion vidéo. |
|
|
object |
Configuration détaillée de la fusion vidéo. |
||
| Duration |
string |
Durée.
|
00000.20 |
| MergeURL |
string |
L'URL du segment de fusion.
|
http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/example-object-****.flv |
| RoleArn |
string |
ARN de rôle utilisé pour l'autorisation de l'agent. |
acs:ram:: |
| Start |
string |
Point de départ.
|
00000.50 |
| MuxConfig |
object |
Configuration de multiplexage. Si vous définissez ce paramètre dans la requête, il remplace le paramètre correspondant dans le modèle de transcodage spécifié. |
|
| Gif |
object |
Configuration de multiplexage GIF. |
|
| DitherMode |
string |
Mode de tramage pour la palette de couleurs. Valeurs valides : sierra, bayer. |
bayer |
| FinalDelay |
string |
Temps de pause pour la dernière image, en centisecondes. |
0 |
| IsCustomPalette |
string |
Fonctionnalité de palette de couleurs personnalisée. Valeurs valides :
|
false |
| Loop |
string |
Nombre de boucles. |
0 |
| Segment |
object |
Configuration de la segmentation, sous forme d'objet JSON. |
|
| Duration |
string |
Durée du segment. Entier, en secondes.
|
20 |
| Webp |
object |
Configuration de multiplexage WEBP. |
|
| Loop |
string |
Nombre de boucles. |
0 |
| OpeningList |
object |
||
| Opening |
array<object> |
Liste des introductions, sous forme d'objet JSON. |
|
|
object |
Paramètres de réponse. |
||
| Height |
string |
Hauteur.
|
1080 |
| Start |
string |
Heure de début par rapport à la vidéo principale. Délai avant l'affichage de la vidéo d'introduction.
|
1 |
| Width |
string |
Largeur.
|
1920 |
| openUrl |
string |
URL OSS de la vidéo d'introduction. |
http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv |
| OutSubtitleList |
object |
||
| OutSubtitle |
array<object> |
Liste des sous-titres de sortie. |
|
|
array<object> |
Détails des sous-titres de sortie. |
||
| Map |
string |
Piste vidéo. Format : |
0:v:0 |
| Message |
string |
Message d'erreur en cas d'échec de la création de la tâche. Ce paramètre n'est pas renvoyé si la création de la tâche réussit. |
Le paramètre spécifié « %s » ne peut pas être null |
| OutSubtitleFile |
object |
Détails du fichier de sortie. |
|
| Bucket |
string |
Compartiment OSS pour le fichier d'entrée. |
example-bucket-**** |
| Location |
string |
Emplacement OSS pour le fichier de sortie. |
oss-cn-hangzhou |
| Object |
string |
Objet OSS pour le fichier de sortie. |
example-output.flv |
| RoleArn |
string |
ARN de rôle utilisé pour l'autorisation de l'agent. |
acs:ram:: |
| Success |
boolean |
Indique si l'opération a réussi. Valeurs valides :
|
true |
| OutputFile |
object |
Fichier de sortie. |
|
| Bucket |
string |
Compartiment OSS pour le fichier d'entrée. |
example-bucket-**** |
| Location |
string |
Emplacement OSS pour le fichier de sortie. |
oss-cn-hangzhou |
| Object |
string |
Objet OSS pour le fichier de sortie. |
example-output.flv |
| RoleArn |
string |
ARN de rôle utilisé pour l'autorisation de l'agent. |
acs:ram:: |
| Priority |
string |
Priorité de la tâche au sein de son pipeline correspondant.
|
5 |
| Properties |
object |
Propriétés du média. |
|
| Bitrate |
string |
Débit binaire. |
1000 |
| Duration |
string |
Durée. |
55 |
| FileFormat |
string |
Format de fichier. |
QuickTime / MOV |
| FileSize |
string |
Taille du fichier. |
3509895 |
| Format |
object |
Informations de format. |
|
| Bitrate |
string |
Débit binaire total. |
1000 |
| Duration |
string |
Durée totale. |
55 |
| FormatLongName |
string |
Nom long du format de conteneur ou d'encapsulation. |
QuickTime / MOV |
| FormatName |
string |
Nom court du format de conteneur ou d'encapsulation. Valeurs valides : mov, mp4, m4a, 3gp, 3g2, mj2. |
mov |
| NumPrograms |
string |
Nombre total de flux de programme. |
0 |
| NumStreams |
string |
Nombre total de flux multimédias. |
2 |
| Size |
string |
Taille du fichier. |
3509895 |
| StartTime |
string |
Heure de début. |
0.000000 |
| Fps |
string |
Fréquence d'images, numérique. |
25 |
| Height |
string |
Hauteur de la vidéo. |
720 |
| Streams |
object |
Informations sur les flux. |
|
| AudioStreamList |
object |
||
| AudioStream |
array<object> |
Liste des flux audio. |
|
|
object |
Détails du flux audio. |
||
| Bitrate |
string |
Débit binaire. |
128.806 |
| ChannelLayout |
string |
Style de sortie des canaux audio. |
stereo |
| Channels |
string |
Nombre de canaux audio. |
2 |
| CodecLongName |
string |
Nom long du format d'encodage. |
AAC (Advanced Audio Coding) |
| CodecName |
string |
Nom court du format d'encodage. |
aac |
| CodecTag |
string |
Balise du format d'encodage. |
0x6134706d |
| CodecTagString |
string |
Texte de la balise du format d'encodage. |
mp4a |
| CodecTimeBase |
string |
Base de temps du codec. |
1/44100 |
| Duration |
string |
Durée. |
17.159546 |
| Index |
string |
Index du flux audio. Identifie la position du flux audio au sein de l'ensemble du flux multimédia. |
1 |
| Lang |
string |
Langue. Pour plus d'informations, consultez Définition des langues FFmpeg et ISO-639. |
eng |
| NumFrames |
string |
Nombre total d'images. |
25 |
| SampleFmt |
string |
Format d'échantillonnage. |
fltp |
| Samplerate |
string |
Taux d'échantillonnage. |
44100 |
| StartTime |
string |
Heure de début. |
0.000000 |
| Timebase |
string |
Base de temps. |
1/44100 |
| SubtitleStreamList |
object |
||
| SubtitleStream |
array<object> |
Liste des flux de sous-titres. |
|
|
object |
Détails du flux de sous-titres. |
||
| Index |
string |
Index du flux de sous-titres. Identifie la position du flux de sous-titres au sein de l'ensemble du flux multimédia. |
1 |
| Lang |
string |
Langue. Pour plus d'informations, consultez Définition des langues FFmpeg et ISO-639. |
eng |
| VideoStreamList |
object |
||
| VideoStream |
array<object> |
Liste des flux vidéo. |
|
|
array<object> |
Détails du flux vidéo. |
||
| AvgFPS |
string |
Fréquence d'images moyenne. |
23.976025 |
| Bitrate |
string |
Débit binaire. |
1496.46 |
| CodecLongName |
string |
Nom long du format d'encodage. |
H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10 |
| CodecName |
string |
Nom court du format d'encodage. |
h264 |
| CodecTag |
string |
Balise du format d'encodage. |
0x31637661 |
| CodecTagString |
string |
Texte de la balise du format d'encodage. |
avc1 |
| CodecTimeBase |
string |
Base de temps du codec. |
1001/48000 |
| Dar |
string |
Rapport d'aspect de l'affichage. |
16:9 |
| Duration |
string |
Durée. |
17.225542 |
| Fps |
string |
Fréquence d'images. |
23.976025 |
| HasBFrames |
string |
Indique si des trames B existent. |
2 |
| Height |
string |
Hauteur de la résolution vidéo. |
720 |
| Index |
string |
Index du flux vidéo. Identifie la position du flux vidéo au sein de l'ensemble du flux multimédia. |
0 |
| Lang |
string |
Langue. Pour plus d'informations, consultez Définition des langues FFmpeg et ISO-639. |
eng |
| Level |
string |
Profil d'encodage. |
51 |
| NetworkCost |
object |
Consommation de bande passante réseau. |
|
| AvgBitrate |
string |
Débit binaire moyen. |
100 |
| CostBandwidth |
string |
Bande passante maximale consommée. |
10 |
| PreloadTime |
string |
Temps de préchargement. |
8 |
| NumFrames |
string |
Nombre total d'images. |
25 |
| PixFmt |
string |
Format de pixel. |
yuv420p |
| Profile |
string |
Profil de codec. |
high |
| Sar |
string |
Rapport d'aspect de l'échantillon. |
1:1 |
| StartTime |
string |
Heure de début. |
0.000000 |
| Timebase |
string |
Base de temps. |
1/24000 |
| Width |
string |
Largeur de la résolution vidéo, numérique. |
1280 |
| Width |
string |
Largeur de la vidéo. |
1280 |
| Rotate |
string |
Angle de rotation de la vidéo dans le sens des aiguilles d'une montre. |
180 |
| SubtitleConfig |
object |
Informations de configuration des sous-titres. |
|
| ExtSubtitleList |
object |
||
| ExtSubtitle |
array<object> |
Liste des sous-titres externes. Un tableau JSON contenant un maximum de 4 éléments. |
|
|
array<object> |
Détails des sous-titres externes. |
||
| CharEnc |
string |
Encodage de caractères pour les sous-titres externes.
Remarque
Lorsque l'encodage de caractères des sous-titres externes est défini sur auto, des erreurs de détection peuvent survenir. Nous vous recommandons de spécifier un encodage de caractères spécifique. |
UTF-8 |
| FontName |
string |
Nom de la police pour la conversion des sous-titres externes en sous-titres incrustés. Valeur par défaut : SimSun. Pour plus d'informations sur les polices, consultez Liste des polices. |
"WenQuanYi Zen Hei", "Yuanti SC Regular", "SimSun" |
| Input |
object |
Objet JSON pour le fichier de sous-titres d'entrée externe. Prend actuellement en charge les formats srt et ass. |
|
| Bucket |
string |
Compartiment OSS pour le fichier d'entrée. |
example-bucket-**** |
| Location |
string |
Emplacement OSS pour le fichier d'entrée. |
oss-cn-hangzhou |
| Object |
string |
Objet OSS pour le fichier d'entrée. |
example-output.flv |
| SubtitleList |
object |
||
| Subtitle |
array<object> |
Liste des sous-titres. |
|
|
object |
Paramètres de réponse. |
||
| Map |
string |
Piste audio. Format : |
0:a:0 |
| SuperReso |
object |
La résolution suit celle de la source. |
|
| IsHalfSample |
string |
Indique s'il faut obtenir les paramètres liés au taux d'échantillonnage. Valeurs valides :
|
true |
| TailSlateList |
object |
||
| TailSlate |
array<object> |
Liste des ardoises de fin, sous forme d'objet JSON. |
|
|
object |
Paramètres de réponse. |
||
| BgColor |
string |
Si la largeur et la hauteur de la vidéo de l'ardoise de fin sont inférieures à celles de la vidéo principale, définissez la couleur d'arrière-plan pour les zones vides. La valeur par défaut est White. Pour plus de valeurs, consultez bgcolor. |
White |
| BlendDuration |
string |
Durée de la transition entre la vidéo principale et l'ardoise de fin. L'effet est un fondu enchaîné : la dernière image de la vidéo principale est affichée pendant la lecture de la vidéo de l'ardoise de fin. La dernière image de la vidéo principale s'estompe progressivement, tandis que la vidéo de l'ardoise de fin apparaît progressivement. Unité : secondes. Valeur par défaut : 0. |
2 |
| Height |
string |
Hauteur.
|
1080 |
| IsMergeAudio |
boolean |
Indique si le contenu audio de la vidéo d'ardoise de fin doit être fusionné. Valeurs valides :
|
false |
| Start |
string |
Heure de début. |
1 |
| TailUrl |
string |
URL OSS de la vidéo de l'ardoise de fin. |
http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv |
| Width |
string |
Largeur.
|
1920 |
| TemplateId |
string |
Identifiant du modèle de transcodage. |
S00000000-000010 |
| TransConfig |
object |
Configuration générale de transcodage. Remarque
Si vous définissez cette valeur dans la requête, elle remplace le paramètre correspondant dans le modèle de transcodage spécifié. |
|
| AdjDarMethod |
string |
Méthode de réécriture de la résolution. Valeur par défaut : none. Valeurs valides :
|
crop |
| 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, ce qui signifie que le paramètre de débit binaire audio défini ne prendra pas effet. Cette valeur a une priorité inférieure à celle de IsCheckAudioBitrateFail.
|
false |
| IsCheckAudioBitrateFail |
string |
Indique si le débit binaire audio doit être vérifié. Cette valeur a une priorité supérieure à IsCheckAudioBitrate. Si le débit binaire audio de sortie est supérieur au débit binaire audio source, le transcodage n'est pas effectué et la tâche échoue directement.
|
true |
| 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 fonction de la largeur ou de la hauteur), la résolution de sortie est considérée comme égale à la résolution d'entrée.
|
false |
| IsCheckResoFail |
string |
Indique si la résolution doit être vérifiée. Cette valeur a une priorité supérieure à IsCheckReso. Si la résolution de sortie est supérieure à la résolution d'entrée (en fonction de la largeur ou de la hauteur), le transcodage n'est pas effectué et la tâche échoue directement.
|
false |
| IsCheckVideoBitrate |
string |
Indique si le débit vidéo doit être vérifié. Si le débit vidéo de sortie est supérieur au débit vidéo d'entrée, le débit vidéo de sortie est considéré comme égal au débit vidéo d'entrée.
|
false |
| IsCheckVideoBitrateFail |
string |
Indique si le débit binaire doit être vérifié. Si le débit binaire de la vidéo de sortie est supérieur à celui de la vidéo source, le transcodage n'est pas effectué et la tâche échoue directement. Cette valeur a une priorité supérieure à IsCheckVideoBitrate.
|
true |
| TransMode |
string |
Mode de transcodage. Valeurs valides :
|
onepass |
| UserData |
string |
Données définies par l'utilisateur. |
données d'exemple |
| Video |
object |
Configuration vidéo. Remarque
Si ce paramètre est spécifié, il remplace les paramètres AliyunVideoCodec du modèle spécifié par TemplateId. |
|
| Bitrate |
string |
Débit du fichier vidéo de sortie. Unité : Kbps. |
10 |
| BitrateBnd |
object |
Plage de débit vidéo moyen. |
|
| Max |
string |
Débit total maximum. Unité : Kbps. |
20 |
| Min |
string |
Débit total minimum. Unité : Kbps. |
10 |
| Bufsize |
string |
Taille du tampon. |
1000 |
| Codec |
string |
Format du codec.
|
H.264 |
| Crf |
string |
Facteur de contrôle du rapport débit-qualité.
|
22 |
| Crop |
string |
Rognage des images vidéo. Prend en charge deux méthodes :
|
1280:800:0:140 |
| Degrain |
string |
Force de l'algorithme de débruitage indépendant. |
5 |
| Fps |
string |
Fréquence d'images.
|
60 |
| Gop |
string |
Intervalle de temps maximal ou nombre maximal d'images entre les images clés. Unité : secondes (s).
|
1 |
| Height |
string |
Hauteur. |
1280 |
| MaxFps |
string |
Fréquence d'images maximale. |
15 |
| Maxrate |
string |
Débit vidéo de crête. Unité : Kbps. |
10 |
| Pad |
string |
Remplissage vidéo avec des bandes noires.
|
1280:800:0:140 |
| PixFmt |
string |
Le format de couleur vidéo.
|
yuvj420p |
| Preset |
string |
Préréglage de l'algorithme vidéo. Valeur par défaut : medium. Valeurs valides :
|
veryfast |
| Profile |
string |
Profil d'encodage. Actuellement pris en charge uniquement pour H.264. Valeur par défaut : high. Valeurs valides : Remarque
Si vous disposez de plusieurs définitions, nous vous recommandons de définir la définition la plus basse sur baseline afin de garantir la lecture sur les appareils d'entrée de gamme. Définissez les autres définitions sur main ou high.
|
baseline |
| Qscale |
string |
Valeur de contrôle de la qualité vidéo. |
15 |
| ResoPriority |
string |
Priorité des ressources. |
1 |
| ScanMode |
string |
Mode de balayage. Valeurs valides :
Meilleure pratique : bien que le balayage entrelacé permette d'économiser plus de données que le balayage progressif, la qualité de l'image est moindre. Par conséquent, la production vidéo actuelle utilise désormais le balayage progressif.
|
interlaced |
| Width |
string |
Largeur. |
1080 |
| VideoStreamMap |
string |
Index du flux vidéo.
|
0:a:0 |
| WaterMarkConfigUrl |
string |
URL du fichier de configuration du filigrane. |
http://example.com/configure |
| WaterMarkList |
object |
||
| WaterMark |
array<object> |
Liste des filigranes. Remarque
Si la sortie du filigrane est tronquée ou échoue, vérifiez si votre filigrane textuel contient des caractères spéciaux. Le cas échéant, échappez les caractères spéciaux avant de les transmettre, ou soumettez un ticket au support d'Alibaba Cloud pour la gestion de la compatibilité. |
|
|
array<object> |
Détails du filigrane. |
||
| Dx |
string |
Le décalage horizontal de l'image du filigrane par rapport à la vidéo de sortie. Si cette valeur est définie dans la requête, elle remplace le paramètre correspondant dans le modèle de filigrane. La valeur par défaut est 0. La valeur peut se présenter sous deux formes :
|
1 |
| Dy |
string |
Le décalage vertical de l'image du filigrane par rapport à la vidéo de sortie. Si cette valeur est définie dans la requête, elle remplace le paramètre correspondant dans le modèle de filigrane. La valeur peut se présenter sous deux formes :
|
1 |
| Height |
string |
Hauteur de l'image du filigrane. Si cette valeur est définie dans la requête, elle remplace le paramètre correspondant dans le modèle de filigrane. La valeur peut se présenter sous deux formes :
|
1280 |
| InputFile |
object |
Fichier d'entrée du filigrane. Prend actuellement en charge les images PNG et les fichiers MOV en entrée. |
|
| Bucket |
string |
Compartiment OSS pour le fichier d'entrée. |
example-bucket |
| Location |
string |
Emplacement OSS pour le fichier d'entrée. |
oss-cn-hangzhou |
| Object |
string |
Objet OSS pour le fichier d'entrée. |
example-logo-****.png |
| ReferPos |
string |
La position du filigrane. Si cette valeur est définie dans la requête, elle remplace le paramètre correspondant dans le modèle de filigrane. Valeurs valides :
|
TopRight |
| Type |
string |
Type de filigrane. Si cette valeur est définie dans la requête, elle remplace le paramètre correspondant dans le modèle de filigrane. Pour plus d'informations, consultez Détails des paramètres. Valeurs valides :
|
Image |
| WaterMarkTemplateId |
string |
L'identifiant du modèle de filigrane. |
88c6ca184c0e47098a5b665e2a12**** |
| Width |
string |
Largeur de l'image de filigrane. Si cette valeur est définie dans la requête, elle remplace le paramètre correspondant dans le modèle de filigrane. La valeur peut se présenter sous deux formes :
|
1080 |
| Percent |
integer |
La progression du transcodage. |
100 |
| PipelineId |
string |
L'identifiant du pipeline. |
88c6ca184c0e47098a5b665e2a126797 |
| State |
string |
État de la tâche.
|
Submitted |
| 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. |
| Success |
boolean |
Indique si la tâche a réussi. Valeurs valides :
|
true |
| RequestId |
string |
L'identifiant de la requête. |
25818875-5F78-4A45S71F6-D73936451234 |
Exemples
JSON format
{
"JobResultList": {
"JobResult": [
{
"Code": "InvalidParameter.NullValue",
"Job": {
"Code": "InternalError",
"CreationTime": "2014-01-10T12:00:00Z",
"FinishTime": "2014-01-10T12:20:00Z",
"Input": {
"Bucket": "example-bucket-****",
"Location": "oss-cn-hangzhou",
"Object": "example.flv"
},
"JobId": "31fa3c9ca8134f9cec2b4b0b0f78****",
"MNSMessageResult": {
"ErrorCode": "InvalidParameter.ResourceNotFound",
"ErrorMessage": "The resource operated \"%s\" cannot be found",
"MessageId": "123"
},
"Message": "The operation has failed due to some unknown error, exception or failure",
"Output": {
"AmixList": {
"Amix": [
{
"AmixURL": "https://outpu***.oss-cn-shanghai.aliyuncs.com/mp4-to-mp3%5E1571025263578816%40.mp3",
"Duration": "20",
"Map": "0:a:0",
"MixDurMode": "long",
"Start": "0"
}
]
},
"Audio": {
"Bitrate": "128",
"Channels": "6",
"Codec": "aac",
"Profile": "aac_low",
"Qscale": "15",
"Samplerate": "32000",
"Volume": {
"Level": "-20",
"Method": "auto"
}
},
"AudioStreamMap": "0:a:0",
"Clip": {
"TimeSpan": {
"Duration": "01:00:59.999",
"Seek": "01:59:59.999"
}
},
"Container": {
"Format": "flv"
},
"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}]}",
"DigiWaterMark": {
"Alpha": "1.0",
"InputFile": {
"Bucket": "example-bucket-****",
"Location": "oss-cn-hangzhou",
"Object": "example-intput.flv"
},
"Type": "Image"
},
"Encryption": {
"Id": "31fa3c9ca8134f9cec2b4b0b0f78****",
"Key": "encryptionkey128",
"KeyType": "Base64",
"KeyUri": "https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/",
"SkipCnt": "3",
"Type": "hls-aes-128"
},
"M3U8NonStandardSupport": {
"TS": {
"Md5Support": true,
"SizeSupport": true
}
},
"MergeConfigUrl": "`{\"MergeList\":[{\"MergeURL\":\"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4\"}]}`",
"MergeList": {
"Merge": [
{
"Duration": "00000.20",
"MergeURL": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/example-object-****.flv",
"RoleArn": "acs:ram:::role/",
"Start": "00000.50"
}
]
},
"MuxConfig": {
"Gif": {
"DitherMode": "bayer",
"FinalDelay": "0",
"IsCustomPalette": "false",
"Loop": "0"
},
"Segment": {
"Duration": "20"
},
"Webp": {
"Loop": "0"
}
},
"OpeningList": {
"Opening": [
{
"Height": "1080",
"Start": "1",
"Width": "1920",
"openUrl": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv"
}
]
},
"OutSubtitleList": {
"OutSubtitle": [
{
"Map": "0:v:0",
"Message": "Le paramètre spécifié « %s » ne peut pas être null",
"OutSubtitleFile": {
"Bucket": "example-bucket-****",
"Location": "oss-cn-hangzhou",
"Object": "example-output.flv",
"RoleArn": "acs:ram:::role/"
},
"Success": true
}
]
},
"OutputFile": {
"Bucket": "example-bucket-****",
"Location": "oss-cn-hangzhou",
"Object": "example-output.flv",
"RoleArn": "acs:ram:::role/"
},
"Priority": "5",
"Properties": {
"Bitrate": "1000",
"Duration": "55",
"FileFormat": "QuickTime / MOV",
"FileSize": "3509895",
"Format": {
"Bitrate": "1000",
"Duration": "55",
"FormatLongName": "QuickTime / MOV",
"FormatName": "mov",
"NumPrograms": "0",
"NumStreams": "2",
"Size": "3509895",
"StartTime": "0.000000"
},
"Fps": "25",
"Height": "720",
"Streams": {
"AudioStreamList": {
"AudioStream": [
{
"Bitrate": "128.806",
"ChannelLayout": "stereo",
"Channels": "2",
"CodecLongName": "AAC (Advanced Audio Coding)",
"CodecName": "aac",
"CodecTag": "0x6134706d",
"CodecTagString": "mp4a",
"CodecTimeBase": "1/44100",
"Duration": "17.159546",
"Index": "1",
"Lang": "eng",
"NumFrames": "25",
"SampleFmt": "fltp",
"Samplerate": "44100",
"StartTime": "0.000000",
"Timebase": "1/44100"
}
]
},
"SubtitleStreamList": {
"SubtitleStream": [
{
"Index": "1",
"Lang": "eng"
}
]
},
"VideoStreamList": {
"VideoStream": [
{
"AvgFPS": "23.976025",
"Bitrate": "1496.46",
"CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
"CodecName": "h264",
"CodecTag": "0x31637661",
"CodecTagString": "avc1",
"CodecTimeBase": "1001/48000",
"Dar": "16:9",
"Duration": "17.225542",
"Fps": "23.976025",
"HasBFrames": "2",
"Height": "720",
"Index": "0",
"Lang": "eng",
"Level": "51",
"NetworkCost": {
"AvgBitrate": "100",
"CostBandwidth": "10",
"PreloadTime": "8"
},
"NumFrames": "25",
"PixFmt": "yuv420p",
"Profile": "high",
"Sar": "1:1",
"StartTime": "0.000000",
"Timebase": "1/24000",
"Width": "1280"
}
]
}
},
"Width": "1280"
},
"Rotate": "180",
"SubtitleConfig": {
"ExtSubtitleList": {
"ExtSubtitle": [
{
"CharEnc": "UTF-8",
"FontName": "\"WenQuanYi Zen Hei\", \"Yuanti SC Regular\", \"SimSun\"",
"Input": {
"Bucket": "example-bucket-****",
"Location": "oss-cn-hangzhou",
"Object": "example-output.flv"
}
}
]
},
"SubtitleList": {
"Subtitle": [
{
"Map": "0:a:0"
}
]
}
},
"SuperReso": {
"IsHalfSample": "true"
},
"TailSlateList": {
"TailSlate": [
{
"BgColor": "White",
"BlendDuration": "2",
"Height": "1080",
"IsMergeAudio": false,
"Start": "1",
"TailUrl": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv",
"Width": "1920"
}
]
},
"TemplateId": "S00000000-000010",
"TransConfig": {
"AdjDarMethod": "crop",
"IsCheckAudioBitrate": "false",
"IsCheckAudioBitrateFail": "true",
"IsCheckReso": "false",
"IsCheckResoFail": "false",
"IsCheckVideoBitrate": "false",
"IsCheckVideoBitrateFail": "true",
"TransMode": "onepass"
},
"UserData": "données d'exemple",
"Video": {
"Bitrate": "10",
"BitrateBnd": {
"Max": "20",
"Min": "10"
},
"Bufsize": "1000",
"Codec": "H.264",
"Crf": "22",
"Crop": "1280:800:0:140",
"Degrain": "5",
"Fps": "60",
"Gop": "1",
"Height": "1280",
"MaxFps": "15",
"Maxrate": "10",
"Pad": "1280:800:0:140",
"PixFmt": "yuvj420p",
"Preset": "veryfast",
"Profile": "baseline",
"Qscale": "15",
"ResoPriority": "1",
"ScanMode": "interlaced",
"Width": "1080"
},
"VideoStreamMap": "0:a:0",
"WaterMarkConfigUrl": "http://example.com/configure",
"WaterMarkList": {
"WaterMark": [
{
"Dx": "1",
"Dy": "1",
"Height": "1280",
"InputFile": {
"Bucket": "example-bucket",
"Location": "oss-cn-hangzhou",
"Object": "example-logo-****.png"
},
"ReferPos": "TopRight",
"Type": "Image",
"WaterMarkTemplateId": "88c6ca184c0e47098a5b665e2a12****",
"Width": "1080"
}
]
}
},
"Percent": 100,
"PipelineId": "88c6ca184c0e47098a5b665e2a126797",
"State": "Submitted"
},
"Message": "Le paramètre spécifié \"%s\" ne peut pas être null",
"Success": true
}
]
},
"RequestId": "25818875-5F78-4A45S71F6-D73936451234"
}
Codes d'erreur
Consultez Codes d'erreur pour la liste complète.
Notes de version
Consultez Notes de version pour la liste complète.