Tous les produits
Search

Ce produit

    ApsaraVideo Media Processing:SubmitMediaCensorJob

    Centre de documentation

    ApsaraVideo Media Processing:SubmitMediaCensorJob

    Dernière mise à jour :Sep 17, 2026

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

    Description de l'opération

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

    • La fonctionnalité de modération de contenu n'est actuellement disponible que dans les régions Chine (Pékin), Chine (Shanghai) et Asie-Pacifique Sud-Est 1 (Singapour). Les autres régions ne sont pas prises en charge.

    Limite de QPS

    La limite de requêtes par seconde (QPS) pour un seul utilisateur pour cette opération est de 100. Si cette limite est dépassée, les appels d'API sont limités, ce qui peut affecter votre activité. Appelez cette opération selon vos besoins. 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

    *Toutes les ressources.

    *

    		 Aucune Aucune

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    Input

    string

    Non

    L'adresse OSS du fichier multimédia à modérer. Les fichiers vidéo et les fichiers audio sont pris en charge. Vous pouvez obtenir l'adresse depuis la console ApsaraVideo Media Processing > Gestion des médias > Bibliothèque de médias. Pour modérer des fichiers image, utilisez le paramètre CoverImage. Il s'agit d'un objet JSON. Pour plus d'informations, consultez Input.

    • Bucket : le nom du bucket OSS pour le fichier d'entrée.

    • Location : la région OSS, qui doit être identique à la région du service ApsaraVideo Media Processing.

    • Object : l'objet OSS à modérer.

      Remarque

      La valeur de Object 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 fichiers OSS des images de couverture. Vous pouvez obtenir les fichiers depuis la console ApsaraVideo Media Processing > Gestion des médias > Bibliothèque de médias. Un maximum de cinq images de couverture est pris en charge. Il s'agit d'un tableau JSON.

    • Bucket : le nom du bucket OSS pour le fichier d'entrée.

    • Location : la région OSS, qui doit être identique à la région du service ApsaraVideo Media Processing.

    • Object : l'objet OSS à modérer.

      Remarque

      La valeur de Object 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.

    description d'exemple
    Barrages

    string

    Non

    La chaîne.

    bonjour le monde
    PipelineId

    string

    Non

    L'identifiant de la file d'attente MPS, qui est utilisé pour lier les notifications de messages. Vous pouvez obtenir l'identifiant depuis la console ApsaraVideo Media Processing > Paramètres globaux > File d'attente MPS. Si vous laissez ce paramètre vide, la file d'attente MPS par défaut est utilisée pour exécuter la tâche. La file d'attente MPS par défaut prend en charge une simultanéité de 10. Pour augmenter la simultanéité, soumettez un ticket.

    Remarque

    Les files d'attente MPS ne peuvent être créées que dans le backend. Pour les opérations de requête et de mise à jour associées, consultez UpdatePipeline.

    b22c173cced04565b1f38f1ecc39****
    VideoCensorConfig

    string

    Oui

    La configuration de modération vidéo et l'adresse OSS pour les instantanés de sortie. Vous pouvez obtenir l'adresse depuis la console ApsaraVideo Media Processing > Gestion des médias > Bibliothèque de médias.

    Objet JSON.

    • OutputFile :

      • Bucket : le nom du bucket OSS pour le fichier de sortie.

      • Location : la région OSS, qui doit être identique à la région du service ApsaraVideo Media Processing.

      • Object : l'objet OSS à modérer. {Count} est l'espace réservé pour le numéro de séquence des images capturées.

      Les résultats détaillés de la modération sont enregistrés dans le même dossier que OutputFile, nommé {jobId}.output. Pour le format de champ spécifique du fichier de sortie, consultez Champs du fichier de résultats de modération de contenu.

    • 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 ou sur false pour ignorer la génération. Si vous laissez ce paramètre vide, le fichier n'est pas généré par défaut. Pour le format de fichier, consultez QueryMediaCensorJobDetail (exemple videoTimeline).

    • SaveType : le mode de sortie. Définissez la valeur sur abnormal pour générer uniquement les images problématiques, ou sur all pour générer toutes les images.

    • Biztype : le modèle de modération. Le modèle par défaut est common. Si vous laissez ce paramètre vide, common est utilisé par défaut. Pour personnaliser un modèle de modération, soumettez un ticket, puis saisissez l'UID de l'utilisateur dans ce champ.

    • Scene : le scénario de détection. Vous pouvez sélectionner des scénarios de détection. Si vous laissez ce paramètre vide, la détection de terrorisme et de pornographie est utilisée par défaut. Scénarios disponibles :

      • porn : détection de pornographie

      • terrorism : détection de terrorisme

      • ad : détection de violations d'images et de textes

      • live : détection de scènes indésirables

      • logo : détection de logos

      • audio : détection anti-spam audio

    Remarque

    Pour les fichiers d'entrée avec des pistes audio, le scénario audio effectue une modération audio. Ne spécifiez pas audio pour les fichiers d'entrée sans pistes audio.

    {"Scenes" : ["porn"], "OutputFile":{"Bucket": "example-001","Location": "oss-cn-hangzhou","Object": "test/example-{Count}.jpg"},"SaveType" : "abnormal","BizType":"common"}
    UserData

    string

    Non

    Les 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 contenu. Conservez cet identifiant pour l'utiliser lors de l'appel d'autres opérations.

    88c6ca184c0e47098a5b665e2****

    Paramètres de message de notification asynchrone

    ParamètreTypeDescription
    TypeStringLe type de message : MediaCensor.
    MediaCensorJobNotifyAliyunMediaCensorJobNotifyLa notification de tâche de modération de contenu.
    UserDataStringLes 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.