SubmitIProductionJob - - Centre de documentation Alibaba Cloud

Remarques d'utilisation

Les tâches soumises via cet appel s'exécutent de manière asynchrone. Une fois ajoutée à la file d'attente ApsaraVideo Media Processing (MPS), la tâche est planifiée. Appelez l'opération QueryIProductionJob ou configurez un rappel pour consulter le résultat de la tâche.

Limites de QPS

Vous pouvez appeler cette opération jusqu'à 100 fois par seconde. Si le nombre d'appels par seconde dépasse cette limite, un mécanisme de limitation se déclenche, ce qui peut affecter votre activité. Tenez compte de cette limite lors de l'appel à cette opération. Pour plus d'informations, consultez la section Limite QPS.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	SubmitIProductionJob	Opération à effectuer. Définissez la valeur sur SubmitIProductionJob.
FunctionName	String	Yes	ImageCartoonize	Nom de l'algorithme à utiliser pour la tâche. Valeurs possibles : VideoH2V : Transforme une vidéo du mode paysage au mode portrait. VideoDelogo : Supprime les logos d'une vidéo. Cover : Génère intelligemment une image de couverture pour une vidéo. VideoClip : Génère intelligemment un résumé pour une vidéo. ImageMatting : Détoure un sujet d'une image. ImageH2V : Transforme une image du mode paysage au mode portrait. ImageDelogo : Supprime les logos d'une image. CaptionExtraction : Extrait les sous-titres d'une vidéo et génère le fichier correspondant. Vous devez spécifier l'URL de la vidéo à traiter. VideoDetext : Supprime les sous-titres d'une vidéo. VideoGreenScreenMatting : Effectue un détourage sur fond vert d'une vidéo et génère une nouvelle vidéo. Vous devez spécifier l'URL de la vidéo à traiter ainsi que l'URL de l'image utilisée pour remplacer l'arrière-plan d'origine. MusicSegmentDetect : Détecte le refrain d'une chanson. Après avoir spécifié l'URL de la vidéo ou de l'audio à traiter, les heures de début et de fin de chaque refrain sont renvoyées. Si aucun refrain n'est détecté, le paramètre renvoyé est vide. AudioMixing : Mixe des flux audio. VideoSplit : Segmente une vidéo de présentation PowerPoint en plusieurs clips vidéo. AudioBeatDetection : Détecte les rythmes. Après avoir spécifié l'URL de la vidéo ou de l'audio à traiter, les paramètres BeatList et DownBeatList sont renvoyés. ASR : Effectue une reconnaissance vocale automatique. AsyncTextToSpeech : Convertit le texte en parole de manière asynchrone. TextToSpeech : Convertit le texte en parole. ImageCartoonize : Convertit un fichier multimédia bidimensionnel en fichier tridimensionnel et stylise les visages. Pour utiliser la fonctionnalité de stylisation, contactez yuanzhigao1209 sur DingTalk.
ModelId	String	No	null	ID du modèle d'algorithme. Nous vous recommandons de ne pas spécifier ce paramètre. Le modèle par défaut correspondant à l'algorithme spécifié sera alors utilisé.
JobParams	String	Yes	null	Paramètres spécifiques à l'algorithme requis pour soumettre la tâche de production intelligente. Ces paramètres sont spécifiés sous forme d'objets JSON et varient selon l'algorithme choisi. Pour plus d'informations, consultez Paramètres spécifiques à l'algorithme pour une tâche de production intelligente.
ScheduleParams	String	No	null	Paramètres requis pour configurer la planification des tâches. Nous vous recommandons de laisser le paramètre ScheduleParams vide.
NotifyUrl	String	No	mns://125340688170****.oss-cn-shanghai.aliyuncs.com/queues/example-pipeline	URL de rappel. Seules les URL des files d'attente Message Service (MNS) sont prises en charge. Pour afficher l'URL, connectez-vous à la console MNS, cliquez sur Queues dans le volet de navigation de gauche, recherchez la file d'attente MNS concernée, puis cliquez sur Details dans la colonne Actions.
UserData	String	No	null	Données métier utilisateur qui seront renvoyées à l'URL de rappel. Nous vous recommandons de laisser ce paramètre vide.
PipelineId	String	Yes	39f8e0bc005e4f309379701645f4****	ID de la file d'attente MPS à laquelle vous souhaitez soumettre la tâche de production intelligente. Pour afficher l'ID, connectez-vous à la console MPS et choisissez Global Settings > Pipelines dans le volet de navigation de gauche. Vous pouvez lier une file d'attente MNS à la file d'attente MPS pour recevoir les rappels de la tâche de production intelligente. Les tâches de production intelligente de différents locataires peuvent être soumises à différentes files d'attente MPS afin de mettre en œuvre l'isolation des données multi-locataires. Si vous ne spécifiez pas ce paramètre, la tâche de production intelligente est soumise à la file d'attente MPS par défaut. Par défaut, une file d'attente MPS peut traiter un maximum de 10 tâches de production intelligente simultanées. Aucun sujet MNS n'est lié à la file d'attente MPS.
Input	String	No	oss://example-****.oss-cn-shanghai.aliyuncs.com/example.mp4	URL du fichier d'entrée. Seules les URL Object Storage Service (OSS) sont prises en charge. Pour obtenir l'URL, connectez-vous à la console MPS et choisissez Media Management > Media List dans le volet de navigation de gauche. Vous pouvez également afficher l'URL dans la console OSS.
Output	String	No	oss://example-****.oss-cn-shanghai.aliyuncs.com/iproduction/{source}-{timestamp}-{sequenceId}.srt	URL du fichier de sortie. Seules les URL OSS sont prises en charge. Pour obtenir l'URL, connectez-vous à la console MPS et choisissez Media Management > Media List dans le volet de navigation de gauche. Vous pouvez également afficher l'URL dans la console OSS. Remarque L'URL doit respecter le format suivant : `oss://example-****.oss-cn-shanghai.aliyuncs.com/iproduction/{source}-{timestamp}-{sequenceId}.srt`. Les champs `{source}`, `{timestamp}` et `{sequenceId}` sont des espaces réservés. Vous pouvez remplacer ces espaces réservés respectivement par un nom de fichier, un horodatage UNIX et un numéro de séquence. Ces espaces réservés ne sont pas obligatoires. Toutefois, pour les algorithmes susceptibles de renvoyer plusieurs résultats, tels que la génération intelligente de couvertures, le champ {sequenceId} est requis pour éviter les doublons d'URL de sortie. Vous pouvez personnaliser l'extension de fichier.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	5210DBB0-E327-4D45-ADBC-0B83C8796E26	ID de la requête.
JobId	String	39f8e0bc005e4f309379701645f4****	ID de la tâche. Nous vous recommandons de conserver cet ID pour les appels d'opérations ultérieurs.
Result	String	null	Résultats de retour. Ceux-ci varient selon l'algorithme. Pour plus d'informations, consultez Paramètres spécifiques à l'algorithme pour une tâche de production intelligente.

Exemples

Exemples de requêtes

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=SubmitIProductionJob
&FunctionName=ImageCartoonize
&ModelId=null
&JobParams={mode:"gif"}
&ScheduleParams=null
&NotifyUrl=mns://125340688170****.oss-cn-shanghai.aliyuncs.com/queues/example-pipeline
&UserData=null
&PipelineId=39f8e0bc005e4f309379701645f4****
&Input=oss://example-****.oss-cn-shanghai.aliyuncs.com/example.mp4
&Output=oss://example-****.oss-cn-shanghai.aliyuncs.com/iproduction/{source}-{timestamp}-{sequenceId}.srt
&<Common request parameters>

Exemples de réponses réussies

Format XML

HTTP/1.1 200 OK
Content-Type:application/xml

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

Format JSON

HTTP/1.1 200 OK
Content-Type:application/json

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

Pour une liste des codes d'erreur, visitez le Centre d'erreurs API.