Tous les produits
Search
Centre de documentation

ApsaraVideo Media Processing:SubmitIProductionJob

Dernière mise à jour :Aug 27, 2026

Soumet une tâche de production intelligente.

Description de l'opération

Les tâches soumises en appelant cette opération sont exécutées en mode asynchrone. La tâche est ajoutée à une file d'attente MPS pour être planifiée et exécutée. Vous pouvez appeler l'opération QueryIProductionJob pour interroger le résultat de l'exécution de la tâche, ou utiliser le mécanisme de notification de messages asynchrones pour obtenir le résultat.

Limite de QPS

Vous pouvez appeler cette opération jusqu'à 100 fois par seconde et par compte. Si le nombre d'appels par seconde dépasse la limite, une limitation de débit est déclenchée. Cela peut affecter votre activité. Pour plus d'informations, consultez Limite 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:SubmitIProductionJob

*Toutes les ressources.

*

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

FunctionName

string

Oui

Le nom de l'algorithme. Pour les régions prises en charge par chaque algorithme, consultez Régions. Valeurs valides :

  • VideoH2V : conversion intelligente paysage-portrait pour vidéo

  • VideoDelogo : suppression de logo vidéo

  • Cover : couverture intelligente

  • VideoClip : synopsis vidéo

  • ImageH2V : conversion intelligente paysage-portrait pour image

  • ImageDelogo : suppression de logo d'image

  • CaptionExtraction : extraction de sous-titres (l'algorithme prend l'URL de la vidéo à traiter en entrée et génère le fichier de sous-titres extrait en sortie)

  • VideoDetext : suppression de sous-titres vidéo

  • VideoGreenScreenMatting : détourage d'image (l'algorithme prend l'URL de la vidéo à détourer et l'URL de l'image d'arrière-plan de remplacement en entrée, et génère la vidéo composée en sortie)

  • MusicSegmentDetect : détection de refrain (prend l'URL de l'audio ou de la vidéo à traiter en entrée, et génère les heures de début et de fin de chaque segment de refrain détecté. Si aucun refrain n'est détecté, un résultat vide est renvoyé)

  • AudioMixing : mixage audio

  • AudioBeatDetection : détection de tempo (prend l'URL de l'audio ou de la vidéo à traiter en entrée, et génère la liste des temps de battement détectés BeatList et la liste des temps forts DownBeatList)

  • ImageCartoonize : style 3D et stylisation de visage (pour utiliser la fonction de stylisation de visage, contactez le compte DingTalk yuanzhigao1209)

  • AudioQualityAssessment : évaluation de la qualité audio

  • FaceBeauty : embellissement de visage vidéo

  • SpeechDenoise : réduction de bruit intelligente

    Remarque

    L'évaluation de la qualité audio prend en charge les fichiers audio WAV quantifiés à 16 bits, les canaux mono ou stéréo, et les fréquences d'échantillonnage allant de 8 000 à 48 000 Hz.

ImageCartoonize

ModelId

string

Non

L'identifiant du modèle d'algorithme. Si ce paramètre est laissé vide, le modèle par défaut de l'algorithme correspondant est utilisé. Dans la plupart des cas, laissez ce paramètre vide pour utiliser le modèle par défaut.

null

JobParams

string

Non

Les paramètres de la tâche de l'algorithme. Il s'agit d'un objet JSON dont le contenu varie en fonction de l'algorithme. Pour plus d'informations, consultez Description supplémentaire des paramètres d'opération de production intelligente.

{"Model":"gif"}

ScheduleParams

string

Non

Les paramètres de planification des tâches pour configurer la planification des tâches. Ce paramètre est facultatif. Laissez-le vide s'il n'est pas nécessaire.

null

NotifyUrl

string

Non

L'URL de rappel. Actuellement, seuls les MNS MSMQ sont pris en charge. Vous pouvez consulter le chemin MSMQ dans la console MNS > Liste des files d'attente > Détails.

mns://125340688170****.mns.cn-beijing.aliyuncs.com/queues/example-pipeline

UserData

string

Non

Les données métier personnalisées qui sont renvoyées dans le message de rappel à l'URL de rappel. Ce paramètre est facultatif. Laissez-le vide s'il n'est pas nécessaire.

{\"key\":\"value\"}

PipelineId

string

Non

L'identifiant de la file d'attente MPS. Vous pouvez obtenir l'identifiant depuis la console MPS > Paramètres globaux > File d'attente MPS. Ce paramètre est utilisé pour déterminer la file d'attente de rappel des tâches et fournir l'isolation des locataires. Si ce paramètre n'est pas spécifié, la file d'attente MPS par défaut est utilisée, laquelle prend en charge un maximum de 10 tâches simultanées et n'est pas liée aux notifications de messages.

39f8e0bc005e4f309379701645f4****

Input

string

Non

Le compartiment OSS du fichier d'entrée. Actuellement, seuls les chemins OSS sont pris en charge, et la région du compartiment OSS doit être identique à celle du service MPS actuel. Vous pouvez obtenir le chemin depuis la console MPS > Gestion des médias > Bibliothèque de médias ou en sélectionnant le compartiment correspondant dans la console OSS.

Remarque

Selon l'algorithme, Input peut être requis dans certains scénarios. Spécifiez ce paramètre en fonction de vos besoins métier.

oss://example-****.oss-cn-shanghai.aliyuncs.com/example.mp4

Output

string

Non

Le compartiment OSS du fichier de sortie. Actuellement, seuls les chemins OSS sont pris en charge. Vous pouvez obtenir le chemin depuis la console MPS > Gestion des médias > Bibliothèque de médias ou en sélectionnant le compartiment correspondant dans la console OSS. La région du compartiment OSS doit être identique à celle du service MPS actuel.

Remarque

Le format est oss://example-****.oss-cn-shanghai.aliyuncs.com/iproduction/{source}-{timestamp}-{sequenceId}.srt, où {source}, {timestamp} et {sequenceId} sont des espaces réservés qui sont remplis respectivement avec le nom du fichier d'entrée, l'horodatage UNIX et le numéro de séquence. Les espaces réservés ne sont pas obligatoires. Cependant, pour les algorithmes qui produisent plusieurs sorties, comme la couverture intelligente, incluez l'espace réservé du numéro de séquence pour garantir l'unicité des chemins de fichiers de sortie. L'extension de fichier est définie par l'utilisateur.

oss://example-****.oss-cn-shanghai.aliyuncs.com/iproduction/{source}-{timestamp}-{sequenceId}.srt

É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.

5210DBB0-E327-4D45-ADBC-0B83C8796E26

JobId

string

L'identifiant de la tâche. Conservez cet identifiant pour l'utiliser lors de l'appel d'autres opérations.

39f8e0bc005e4f309379701645f4****

Result

string

Le résultat renvoyé. Le résultat varie en fonction de l'algorithme. Pour plus d'informations, consultez Description supplémentaire des paramètres d'opération de production intelligente.

{ "Code":"Success", "Details":[], "FunctionName":"ImageCartoonize", "JobId":"39f8e0bc005e4f309379701645f4****", "Message":"success", "State":"Success", "Type":"IProduction" }

Exemples

JSON format

{
  "RequestId": "5210DBB0-E327-4D45-ADBC-0B83C8796E26",
  "JobId": "39f8e0bc005e4f309379701645f4****",
  "Result": "{ \"Code\":\"Success\", \"Details\":[], \"FunctionName\":\"ImageCartoonize\", \"JobId\":\"39f8e0bc005e4f309379701645f4****\", \"Message\":\"success\", \"State\":\"Success\", \"Type\":\"IProduction\" }"
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.