SubmitMediaCensorJob - - Centre de documentation Alibaba Cloud

Soumet une tâche de modération de contenu.

Notes d'utilisation

La tâche soumise via cette opération s'exécute en mode asynchrone. Elle est ajoutée à un pipeline ApsaraVideo Media Processing (MPS), puis planifiée, mise en file d'attente et exécutée. Appelez l'opération QueryMediaCensorJobDetail ou configurez une notification asynchrone pour obtenir le résultat de la tâche.

Limite QPS

Vous pouvez appeler cette opération jusqu'à 100 fois par seconde et par compte. Si le nombre d'appels par seconde dépasse cette limite, un mécanisme de limitation du débit (throttling) 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 la signature. Pour votre commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	SubmitMediaCensorJob	Opération à effectuer. Définissez la valeur sur SubmitMediaCensorJob.
Input	String	No	null	URL Object Storage Service (OSS) du fichier vidéo ou audio à modérer. Pour afficher l'URL OSS du fichier vidéo ou audio, connectez-vous à la MPS console et choisissez Media Management > Media List dans le volet de navigation de gauche. Pour modérer un fichier image, utilisez le paramètre `CoverImage` afin de spécifier l'URL OSS du fichier image. La valeur est un objet JSON. Pour plus d'informations, consultez Input. Bucket : nom du bucket OSS qui stocke le fichier d'entrée. Location : région OSS. La région OSS doit être identique à celle où le service MPS est activé. Object : objet OSS à modérer.
CoverImages	String	No	[{"Bucket":"example-bucket-**","Location":"oss-cn-shanghai","Object":"example-**.jpeg"}]	URL OSS du fichier image utilisé comme vignette. Pour afficher l'URL OSS du fichier image, connectez-vous à la MPS console et choisissez Media Management > Media List dans le volet de navigation de gauche. Vous pouvez spécifier jusqu'à cinq vignettes dans un tableau JSON. Bucket : nom du bucket OSS qui stocke le fichier d'entrée. Location : région OSS. La région OSS doit être identique à celle où le service MPS est activé. Object : objet OSS à modérer.
Title	String	No	Hello World	Titre de la vidéo. La valeur peut atteindre 64 octets.
Description	String	No	example description	Description de la vidéo. La valeur peut atteindre 128 octets.
Barrages	String	No	hello world	Commentaires en direct.
PipelineId	String	Yes	b22c173cced04565b1f38f1ecc39****	ID de la file d'attente MPS. Cet ID permet d'associer la tâche à une méthode de notification. Pour afficher l'ID de la file d'attente MPS, connectez-vous à la MPS console et choisissez Global Settings > Pipelines dans le volet de navigation de gauche. Une chaîne vide ("") indique que la file d'attente MPS par défaut est utilisée pour exécuter la tâche. Par défaut, une file d'attente MPS peut traiter un maximum de 10 tâches de modération de contenu simultanées. Pour augmenter cette limite, soumettez un ticket. Remarque Les files d'attente MPS sont créées automatiquement par le système. Pour plus d'informations sur la consultation et la mise à jour des files d'attente MPS, consultez UpdatePipeline.
VideoCensorConfig	String	Yes	null	Configurations de modération vidéo et URL OSS des snapshots de sortie. Pour afficher les URL OSS des snapshots de sortie, connectez-vous à la MPS console et choisissez Media Management > Media List dans le volet de navigation de gauche. La valeur est un objet JSON. OutputFile : Bucket : nom du bucket OSS qui stocke les snapshots de sortie. Location : région OSS. La région OSS doit être identique à celle où le service MPS est activé. Object : objet OSS à générer. Dans la valeur, {Count} indique le numéro de séquence du snapshot d'image. StoreVideoTimeline : spécifie s'il faut générer le fichier `{jobId}.video_timeline`. Le fichier est stocké dans OSS. La valeur true indique que le fichier est généré. La valeur false indique que le fichier n'est pas généré. Si vous ne spécifiez pas ce paramètre, le fichier n'est pas généré par défaut. Pour plus d'informations sur le format du fichier, consultez l'exemple de fichier {jobId}.video_timeline dans QueryMediaCensorJobDetail. SaveType : mode de sortie. La valeur abnormal indique que des snapshots sont générés uniquement pour les images illégales. La valeur all indique que des snapshots sont générés pour toutes les images. Biztype : modèle de modération. Si vous ne spécifiez pas ce paramètre ou si vous définissez la valeur sur common, le modèle par défaut est utilisé. Vous pouvez soumettre un ticket pour créer un modèle de modération personnalisé. Ensuite, définissez ce paramètre sur votre ID utilisateur pour utiliser le modèle de modération personnalisé. Scenes : scénarios de modération. Vous pouvez spécifier les scénarios de modération que vous souhaitez utiliser. Si vous ne spécifiez pas ce paramètre, les scénarios de modération terrorisme et contenu pornographique sont utilisés par défaut. Valeurs valides : porn : détection de contenu pornographique terrorism : détection de contenu terroriste ad : détection de violation publicitaire live : détection de scènes indésirables logo : détection de logos spéciaux audio : anti-spam audio Remarque Si le fichier d'entrée contient des pistes audio et que le scénario de modération audio est spécifié, les pistes audio sont modérées. Si le fichier d'entrée ne contient pas de pistes audio, il n'est pas nécessaire de spécifier le scénario de modération audio.
UserData	String	No	UserDatatestid-001-****	Données personnalisées. La valeur peut atteindre 128 octets.
ExternalUrl	String	No	http://www.example.com/video-**/test-**.mp4	URL de la vidéo.

Paramètres de réponse

Parameter

Type

Example

Description

| RequestId | String | 25818875-5F78-4A13-BEF6-D7393642CA58 |

ID de la requête.

| JobId | String | 88c6ca184c0e47098a5b665e2**** |

ID de la tâche de modération de contenu. Nous vous recommandons de conserver cet ID pour les appels d'opérations ultérieurs.

Paramètres de notification asynchrone

Parameter

Type

Description

Type

String

Type du message. La valeur est MediaCensor.

MediaCensorJobNotify

AliyunMediaCensorJobNotify

Contenu de notification de la tâche de modération de contenu.

UserData

String

Données personnalisées.

Exemples

Exemples de requêtes

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=SubmitMediaCensorJob
&Input={"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.flv"}
&CoverImages=[{"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.jpeg"}]
&Title=Hello World
&Description=example description
&Barrages=hello world
&PipelineId=b22c173cced04565b1f38f1ecc39****
&VideoCensorConfig={"Scenes" : ["porn"], "OutputFile":{"Bucket": "example-001","Location": "oss-cn-hangzhou","Object": "test/example-{Count}.jpg"},"SaveType" : "abnormal","BizType":"common"}
&UserData=UserDatatestid-001-****
&ExternalUrl=http://www.example.com/video-****/test-****.mp4
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<SubmitMediaCensorJobResponse>
    <RequestId>25818875-5F78-4A13-BEF6-D7393642CA58</RequestId>
    <JobId>88c6ca184c0e47098a5b665e2****</JobId>
</SubmitMediaCensorJobResponse>

JSON format

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

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

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.