SubmitMediaCensorJob - - Centre de documentation Alibaba Cloud

Soumet un fichier média à Intelligent Media Services pour une tâche de modération. Cette API automatise l'analyse de contenu vidéo, audio ou image afin de détecter les éléments potentiellement non conformes, sensibles ou inappropriés.

Description de l'opération

Il s'agit d'une API asynchrone. Après la soumission d'une tâche, le service renvoie un identifiant de tâche et traite la tâche en arrière-plan. Vous recevez le résultat final via une notification de rappel. Vous pouvez également vérifier l'état de la tâche en appelant l'API QueryMediaCensorJob.

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

create

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
TemplateId	string	Non	L'identifiant du modèle. Si ce paramètre est laissé vide, le service utilise le modèle par défaut pour la tâche de modération.	S00000001-100060
CoverImages	string	Non	Les fichiers Object Storage Service (OSS) pour les images de couverture, spécifiés sous forme de tableau JSON. Vous pouvez spécifier jusqu'à cinq images de couverture. Remarque Si ce paramètre est spécifié, il remplace les informations d'image de couverture dans l'objet Media.	[{"Bucket":"example-bucket-**","Location":"oss-cn-shanghai","Object":"example-**.jpeg","RoleArn":"acs:ram::1997018457688683:role/AliyunICEDefaultRole"}]
Title	string	Non	Le titre de la vidéo. La longueur maximale est de 64 octets. Remarque Si ce paramètre est spécifié, il remplace le titre spécifié dans l'objet Media.	Bonjour le monde
Description	string	Non	La description de la vidéo. La longueur maximale est de 128 octets. Remarque Si ce paramètre est spécifié, il remplace la description spécifiée dans l'objet Media.	exemple de description
Barrages	string	Non	Les commentaires superposés (commentaires à l'écran) de la vidéo. Remarque Si ce paramètre est spécifié, il remplace les commentaires superposés spécifiés dans l'objet Media.	bonjour le monde
Output	string	Non	L'emplacement de sortie pour les captures d'écran. La tâche de modération génère des captures d'écran et un fichier JSON de résultats dans l'emplacement OSS spécifié par ce paramètre. Exemple de format : `oss://bucket/snapshot-{Count}.jpg`, où `bucket` est le nom d'un bucket OSS dans la même région que le projet, et `{Count}` est un espace réservé pour le numéro de séquence de la capture d'écran. Les résultats détaillés de la modération sont enregistrés dans un fichier nommé `{jobId}.output` dans le même dossier OSS que la valeur de `Output`. Pour plus d'informations sur les champs du fichier de sortie, consultez Champs du fichier de résultat de modération des médias.	oss://sashimi-cn-shanghai/censor/snapshot-{Count}.jpg
UserData	string	Non	Les données définies par l'utilisateur. La longueur maximale est de 128 octets.	UserDatatestid-001-****
NotifyUrl	string	Non	Le chemin de rappel. Les rappels Message Service (MNS) et HTTP sont tous deux pris en charge.	mns://125340688170****.oss-cn-shanghai.aliyuncs.com/queues/example-pipeline
Input	object	Non	Le fichier d'entrée à modérer.
Type	string	Non	Le type du fichier d'entrée. Valeurs valides : `OSS` : une URL OSS `Media` : un identifiant de média	Media
Media	string	Non	L'identifiant du fichier d'entrée. Vous pouvez spécifier soit une URL OSS, soit un identifiant de média. Formats d'URL OSS valides : 1. `oss://bucket/object` 2. `http(s)://bucket.oss-[regionId].aliyuncs.com/object` Le `bucket` doit se trouver dans la même région que le projet, et `object` est le chemin d'accès au fichier.	1b1b9cd148034739af413150fded****
ScheduleConfig	object	Non	La configuration de planification.
PipelineId	string	Non	L'identifiant du pipeline.	5246b8d12a62433ab77845074039****
Priority	integer	Non	La priorité de la tâche. Une valeur plus élevée indique une priorité plus haute. Les valeurs valides sont comprises entre 1 et 10.	6

É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.	25818875-5F78-4A13-BEF6-D7393642CA58
JobId	string	L'identifiant de la tâche de modération vidéo. Nous vous recommandons d'enregistrer cet identifiant pour les appels d'API ultérieurs.	88c6ca184c0e47098a5b665e2****

Exemples

JSON format

{
  "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  "JobId": "88c6ca184c0e47098a5b665e2****"
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.