SubmitMediaCensorJob - ApsaraVideo Media Processing - Centre de documentation Alibaba Cloud

Description de l'opération

Il s'agit d'une API asynchrone. Après avoir soumis une tâche, le système renvoie un identifiant de tâche et la met en file d'attente pour un traitement asynchrone. Les résultats finaux sont fournis via une notification de rappel. Vous pouvez également appeler l'opération Interroger une tâche de modération de média pour vérifier l'état de la tâche.
La modération de média est disponible dans les régions Chine (Pékin), Chine (Shanghai) et Asie-Pacifique Sud-Est 1 (Singapour). Cette fonctionnalité n'est pas prise en charge dans les autres régions.

Limite de QPS

La limite de requêtes par seconde (QPS) pour cette API est de 100 par utilisateur. Les appels d'API qui dépassent cette limite sont limités en fréquence, ce qui 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:SubmitMediaCensorJob

none

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Input	string	Non	L'URL OSS du fichier média à modérer. Les fichiers vidéo et audio sont pris en charge. Vous pouvez obtenir l'URL depuis la console MPS sous Gestion des médias > Liste des médias. Pour modérer un fichier image, utilisez le paramètre `CoverImage`. Spécifiez ce paramètre sous forme d'objet JSON. Pour plus de détails, consultez Détails de l'entrée. Bucket : le nom du bucket OSS du fichier d'entrée. Location : la région OSS. Celle-ci doit correspondre à la région de votre service MPS. Object : l'objet OSS à analyser. Remarque Le nom de l'objet ne peut pas commencer par une barre oblique (/). Sinon, l'appel d'API échoue.	{"Bucket":"example-bucket-**","Location":"oss-cn-shanghai","Object":"example-**.flv"}
CoverImages	string	Non	Les URL OSS des images de couverture. Vous pouvez obtenir les URL depuis la console MPS sous Gestion des médias > Liste des médias. Vous pouvez spécifier jusqu'à cinq images de couverture. Spécifiez les URL sous forme de tableau JSON. Bucket : le nom du bucket OSS du fichier d'entrée. Location : la région OSS. Celle-ci doit correspondre à la région de votre service MPS. Object : l'objet OSS à analyser. Remarque Le nom de l'objet ne peut pas commencer par une barre oblique (/). Sinon, l'appel d'API échoue.	[{"Bucket":"example-bucket-**","Location":"oss-cn-shanghai","Object":"example-**.jpeg"}]
Title	string	Non	Le titre de la vidéo. La longueur maximale est de 64 octets.	Bonjour le monde
Description	string	Non	La description de la vidéo. La longueur maximale est de 128 octets.	exemple de description
Barrages	string	Non	Les commentaires de type danmaku, fournis sous forme de chaîne.	bonjour le monde
PipelineId	string	Non	L'identifiant du pipeline utilisé pour les notifications de messages. Vous pouvez obtenir l'identifiant depuis la console MPS sous Paramètres globaux > Pipelines. Si vous ne spécifiez pas ce paramètre, le pipeline par défaut est utilisé. Le pipeline par défaut a un parallélisme de 10. Pour augmenter le parallélisme, soumettez une requête. Remarque Actuellement, les pipelines ne peuvent être créés que sur le backend. Pour interroger et mettre à jour les pipelines, consultez Mettre à jour un pipeline.	b22c173cced04565b1f38f1ecc39****
VideoCensorConfig	string	Oui	La configuration de la modération vidéo et l'URL OSS pour les instantanés de sortie. Vous pouvez obtenir l'URL depuis la console MPS sous Gestion des médias > Liste des médias. Ce paramètre est un objet JSON. OutputFile : Bucket : le nom du bucket OSS de sortie. Location : la région OSS. Celle-ci doit être identique à la région où réside le service MPS. Object : l'objet OSS pour la sortie. L'espace réservé {Count} est remplacé par le numéro de séquence de l'instantané. Les résultats détaillés de la modération sont enregistrés dans un fichier nommé {jobId}.output dans le même répertoire que l'OutputFile. Pour plus d'informations sur les champs du fichier de sortie, consultez Champs du fichier de résultat de la modération de média. StoreVideoTimeline : indique s'il faut générer un fichier `{jobId}.video_timeline` et le stocker dans OSS. Définissez la valeur sur `true` pour générer le fichier. Si vous définissez la valeur sur `false` ou omettez le paramètre, le système ne génère pas le fichier. Pour plus de détails sur le format du fichier, consultez Interroger une tâche de média (exemple videoTimeline). SaveType : le mode de sortie. `abnormal` enregistre uniquement les instantanés du contenu problématique. `all` enregistre tous les instantanés. Biztype : le modèle de modération. La valeur par défaut est `common`. Pour utiliser un modèle de modération personnalisé, vous devez soumettre une requête. Une fois votre modèle personnalisé configuré, définissez ce paramètre sur votre identifiant d'utilisateur (UID). Scene : les scènes de détection. Vous pouvez sélectionner une ou plusieurs scènes. Si vous ne spécifiez pas ce paramètre, le système utilise par défaut les scènes `porn` et `terrorism`. Scènes valides : `porn` : contenu pornographique `terrorism` : contenu terroriste `ad` : violations des règles texte-image `live` : scènes indésirables `logo` : logos `audio` : anti-spam audio Remarque Pour les fichiers d'entrée possédant une piste audio, la scène `audio` effectue une modération audio. Ne spécifiez pas la scène `audio` pour les fichiers d'entrée qui n'ont pas de piste audio.	{"Scenes" : ["porn"], "OutputFile":{"Bucket": "example-001","Location": "oss-cn-hangzhou","Object": "test/example-{Count}.jpg"},"SaveType" : "abnormal","BizType":"common"}
UserData	string	Non	Données utilisateur personnalisées. La longueur maximale est de 128 octets.	UserDatatestid-001-****
ExternalUrl	string	Non	L'URL de la vidéo.	http://www.example.com/video-**/test-**.mp4

É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 de média. Conservez cet identifiant pour les appels d'API ultérieurs.	88c6ca184c0e47098a5b665e2****

Paramètres du message de notification asynchrone

Paramètre	Type	Description
Type	String	Le type de message. Valeur : MediaCensor.
MediaCensorJobNotify	AliyunMediaCensorJobNotify	L'objet de notification pour la tâche de modération de média.
UserData	String	Les données utilisateur personnalisées.

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.