Tous les produits
Search

Ce produit

    :SubmitIProductionJob

    Centre de documentation

    :SubmitIProductionJob

    Dernière mise à jour :Aug 06, 2026

    Soumet une tâche de production intelligente en appelant SubmitIProductionJob.

    Description de l'opération

    Il s'agit d'une opération asynchrone. Après la soumission d'une tâche, un identifiant de tâche est renvoyé. La tâche n'est pas encore terminée à ce stade et entre dans une file d'attente en arrière-plan pour une exécution asynchrone. Le résultat final est délivré via une notification de rappel. Vous pouvez également interroger de manière proactive l'état de la tâche en appelant QueryIProductionJob.

    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.

    ice:SubmitIProductionJob

    create

    *All Resource

    *

    		 Aucune Aucune

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    Name

    string

    Non

    Le nom de la tâche. Le nom peut comporter jusqu'à 100 caractères.

    Tâche de test
    FunctionName

    string

    Oui

    Le nom de la fonction d'algorithme à utiliser. Valeurs valides :

    • Cover : couverture intelligente

    • VideoClip : synopsis vidéo

    • VideoDelogo : suppression de logo vidéo

    • VideoDetext : suppression de sous-titres vidéo

    • CaptionExtraction : extraction de sous-titres

    • VideoGreenScreenMatting : détourage d'image

    • FaceBeauty : embellissement de visage vidéo

    • VideoH2V : conversion intelligente paysage vers portrait

    • MusicSegmentDetect : détection de refrain

    • AudioBeatDetection : détection de rythme

    • AudioQualityAssessment : évaluation de la qualité audio

    • SpeechDenoise : débruitage de la parole

    • AudioMixing : mixage audio

    • MusicDemix : séparation des voix et de l'accompagnement

    Cover
    Input

    object

    Oui

    Le média d'entrée. Les chemins Object Storage Service (OSS) et les identifiants de ressource média sont pris en charge.

    Différentes fonctions d'algorithme ont différentes exigences pour les fichiers d'entrée. Pour plus d'informations, consultez la description complémentaire ci-dessous.

    Type

    string

    Oui

    Le type de média. Valeurs valides :

    • OSS : un chemin OSS

    • Media : un identifiant de ressource média

    OSS
    Media

    string

    Oui

    Le média d'entrée. Les chemins OSS et les identifiants de ressource média sont pris en charge. Règles de chemin OSS (utilisez l'un ou l'autre format) :

    1. oss://bucket/object

    2. http(s)://bucket.oss-[regionId].aliyuncs.com/object où bucket est le nom d'un bucket OSS dans la même région que le projet actuel, et object est le chemin du fichier.

    oss://bucket/object
    Output

    object

    Oui

    Le média de sortie. Les chemins OSS et les identifiants de ressource média sont pris en charge.

    Différentes fonctions d'algorithme produisent différents fichiers de sortie. Pour plus d'informations, consultez la description complémentaire ci-dessous.

    Type

    string

    Oui

    Le type de média. Valeurs valides :

    • OSS : un chemin OSS

    • Media : un identifiant de ressource média

    OSS
    Biz

    string

    Non

    Le type d'activité auquel appartient la ressource média.

    IMS
    Media

    string

    Oui

    Le média de sortie. Si Type est défini sur OSS, spécifiez un chemin OSS. Si Type est défini sur Media, spécifiez un identifiant de ressource média.

    Règles de chemin OSS (utilisez l'un ou l'autre format) :

    1. oss://bucket/object

    2. http(s)://bucket.oss-[RegionId].aliyuncs.com/object où bucket est le nom d'un bucket OSS dans la même région que le projet actuel, et object est le chemin du fichier.

    Identifiant de ressource média :

    • Vous pouvez spécifier un MediaId existant.

      • Vous n'avez pas besoin de spécifier Biz. La valeur suit celle de la source.

    • Vous pouvez créer un nouveau MediaId (laissez MediaId vide).

      • La valeur Biz détermine si la ressource média est écrite dans IMS ou VOD. Si Biz n'est pas spécifié, la valeur suit celle de la source ou prend IMS par défaut.

    Remarque

    Le chemin OSS prend en charge les espaces réservés, tels que oss://example-****/iproduction/{source}-{timestamp}-{sequenceId}.png. Les espaces réservés suivants sont pris en charge :

    • {source} : rempli avec le nom du fichier d'entrée

    • {timestamp} : rempli avec l'horodatage UNIX

    • {sequenceId} : rempli avec le numéro de séquence de génération

    • {resultType} : rempli avec le type de fichier de sortie (déterminé par le serveur) Les espaces réservés ne sont pas obligatoires. Cependant, pour les algorithmes avec plusieurs sorties, comme la couverture intelligente, incluez l'espace réservé du numéro de séquence pour garantir des chemins de fichiers de sortie uniques.

    oss://bucket/object
    OutputUrl

    string

    Non

    Le chemin OSS du fichier de sortie lorsque Type est défini sur Media. Le bucket doit être enregistré dans IMS ou VOD.

    http(s)://bucket.oss-[RegionId].aliyuncs.com/object
    TemplateId

    string

    Non

    L'identifiant du modèle.

    ****20b48fb04483915d4f2cd8ac****
    JobParams

    string

    Non

    Les paramètres de la tâche d'algorithme. Il s'agit d'un objet JSON. Les paramètres varient en fonction de l'algorithme. Pour plus d'informations, consultez la description complémentaire.

    {"Model":"gif"}
    ScheduleConfig

    object

    Non

    La configuration de planification de la tâche.

    PipelineId

    string

    Non

    L'identifiant du pipeline.

    5246b8d12a62433ab77845074039c3dc
    Priority

    integer

    Non

    La priorité. Valeurs valides : 1 à 10. Une valeur plus petite indique une priorité plus élevée.

    6
    UserData

    string

    Non

    Les données utilisateur personnalisées, qui sont renvoyées telles quelles lors de la récupération du résultat. La valeur peut comporter jusqu'à 256 caractères.

    {"test":1}
    ModelId

    string

    Non

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

    Les fonctions d'algorithme suivantes disposent de modèles non par défaut :

    • VideoDetext

      • ModelId = algo-video-detext-new : un algorithme de suppression de sous-titres offrant de meilleurs résultats, mais avec une vitesse plus lente et un coût plus élevé que l'algorithme par défaut.

    Description des champs d'entrée et de sortie.

    Cover

    Entrée : un fichier vidéo. Sortie : plusieurs images (3 par défaut, distinguées par des espaces réservés) au format PNG ou GIF (selon le paramètre JobParams, qui détermine si des images statiques ou animées sont générées).

    VideoDelogo

    Entrée : un fichier vidéo. Sortie : une vidéo avec les logos supprimés (au format MP4).

    VideoDetext

    Entrée : un fichier vidéo. Sortie : une vidéo avec les sous-titres supprimés (au format MP4).

    CaptionExtraction

    Entrée : un fichier vidéo. Sortie : un fichier de sous-titres (au format SRT).

    VideoGreenScreenMatting

    Entrée : un fichier vidéo. Sortie : une vidéo après détourage d'image (au format MP4 ou WebM, selon le paramètre JobParams).

    FaceBeauty

    Entrée : un fichier vidéo. Sortie : une vidéo avec embellissement de visage appliqué (au format MP4).

    VideoH2V

    Entrée : un fichier vidéo. Sortie : une vidéo convertie du format paysage au format portrait (au format MP4).

    MusicSegmentDetect

    Entrée : un fichier audio. Sortie : un fichier de résultats contenant les informations de détection de refrain (au format JSON).

    AudioBeatDetection

    Entrée : un fichier audio. Sortie : un fichier de résultats contenant les informations de détection de rythme (au format JSON).

    AudioQualityAssessment

    Entrée : un fichier audio. Aucun fichier de sortie n'est généré. Le résultat de l'évaluation de la qualité audio est renvoyé directement dans QueryIProductionJob.

    SpeechDenoise

    Entrée : un fichier audio. Sortie : un fichier audio débruité (au format WAV).

    AudioMixing

    Entrée : un fichier audio à mixer. Sortie : un fichier audio mixé (au format WAV). Pour plus d'informations sur la façon de spécifier le fichier audio à mixer, consultez les paramètres JobParams ci-dessous.

    MusicDemix

    Entrée : un fichier audio (une chanson). Sortie : deux fichiers audio après séparation des voix et de l'accompagnement. Incluez l'espace réservé {resultType} dans le chemin de sortie pour distinguer la piste vocale de la piste d'accompagnement.

    Description des champs JSON de JobParams.

    Cover

    • Model : String. Le modèle de couverture intelligente. Si laissé vide, des couvertures d'image sont générées. Si défini sur gif, des couvertures animées sont générées.

    VideoDelogo

    • LogoModel : String. Le type de logo à supprimer. Valeurs valides : tv (logo général - chaîne de télévision), internet (logo général - média en ligne). Plusieurs valeurs peuvent être spécifiées, séparées par des virgules.

    • Boxes : String. La position de la boîte du logo cible, spécifiée sous forme de distances normalisées par rapport au coin supérieur gauche : [xmin, ymin, width, height]. Jusqu'à deux boîtes de logo cible sont prises en charge. Exemple : "[[0, 0, 0.3, 0.3], [0.7, 0, 0.3, 0.3]]".

    VideoDetext

    • LimitRegion : List. La région de détection de sous-titres restreinte, spécifiée sous forme de distances normalisées par rapport au coin supérieur gauche : [xmin, ymin, width, height]. Plusieurs régions de détection sont prises en charge. Exemple : [[0, 0, 0.3, 0.3], [0.7, 0, 0.3, 0.3]]. Si ce paramètre n'est pas défini, la région de détection par défaut correspond aux 30 % inférieurs de la vidéo.

    • Time : La plage de temps d'effacement globale (en secondes). Type liste, incluant l'heure de début et l'heure de fin : [start_time, end_time]. Exemple : [5, 20], ce qui signifie que seuls les sous-titres entre 5 et 20 secondes de la vidéo sont effacés.

      • Le paramètre Time peut être un tableau unidimensionnel, tel que [5, 20], pour spécifier une seule plage de temps.

      • Le paramètre Time peut également être un tableau bidimensionnel, tel que [[5, 20], [25, 43], [51, 80]], pour spécifier plusieurs plages de temps (pris en charge uniquement lorsque modelId=algo-video-detext-new).

    CaptionExtraction

    • fps : La fréquence d'échantillonnage des images (facultatif). Integer. Valeurs valides : 2 à 10. Valeur par défaut : 5.

    • roi : La région de sélection des sous-titres (seuls les sous-titres dans cette région sont extraits). Format : [[top, bottom], [left, right]], avec des valeurs normalisées (par exemple, la moitié inférieure : [[0.5, 1], [0, 1]]). Si ce paramètre n'est pas spécifié, le quart inférieur de la vidéo est utilisé par défaut.

    • lang : La langue de reconnaissance. Valeurs valides : ch (chinois), en (anglais), ch_ml (mixte chinois-anglais). Valeur par défaut : ch.

    • track : Si défini sur "main", seule la piste de sous-titres principale est extraite. Si non spécifié, tous les sous-titres dans la région sont extraits par défaut.

    VideoGreenScreenMatting

    • bgimage : L'image d'arrière-plan à superposer après le détourage. Exemple : http://example-image-****.example-location.aliyuncs.com/example/example.jpg. Si ce paramètre n'est pas spécifié, une vidéo WebM avec un canal transparent est générée en sortie.

    FaceBeauty

    VideoH2V

    Aucun.

    MusicSegmentDetect

    Aucun.

    AudioBeatDetection

    Aucun.

    AudioQualityAssessment

    Aucun.

    SpeechDenoise

    Exigences pour l'audio d'entrée : le format doit être WAV et la fréquence d'échantillonnage doit être de 16 kHz ou 48 kHz.

    AudioMixing

    • inputs : La liste des URL de fichiers de pistes audio à mixer. Un seul fichier est pris en charge. Exemple : {"file":"http://example-bucket-****.oss-ap-southeast-1.aliyuncs.com/2.mp4"}

    MusicDemix

    Aucun.

    Éléments de réponse

    Élément

    Type

    Description

    Exemple

    object

    Schéma de la réponse.

    RequestId

    string

    L'identifiant de la requête.

    C1849434-FC47-5DC1-92B6-F7EAAFE3851E
    JobId

    string

    L'identifiant de la tâche de production intelligente.

    ****20b48fb04483915d4f2cd8ac****

    Exemples

    JSON format

    {
  "RequestId": "C1849434-FC47-5DC1-92B6-F7EAAFE3851E",
  "JobId": "****20b48fb04483915d4f2cd8ac****"
}

    Codes d'erreur

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

    Notes de version

    Consultez Notes de version pour la liste complète.