QueryMediaCensorJobList - ApsaraVideo Media Processing - Centre de documentation Alibaba Cloud

Consulte la liste des tâches de modération de contenu.

Description de l'opération

Cette opération interroge les tâches de modération de contenu créées au cours des trois derniers mois.

Limites de QPS

La limite de requêtes par seconde (QPS) pour un utilisateur unique est de 100. Si vous dépassez cette limite, les appels d'API sont limités, ce qui peut affecter votre activité. Appelez cette opération à une fréquence raisonnable. Pour plus d'informations, consultez Limites 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:QueryMediaCensorJobList

get

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
JobIds	string	Non	L'identifiant de la tâche de modération de contenu. Vous pouvez obtenir l'identifiant de la tâche à partir des paramètres de réponse de l'opération SubmitMediaCensorJob. Séparez les identifiants multiples par des virgules (,).	fa9c34be3bcf42919ac4d1775239**,78dc866518b843259669df58ed30**
NextPageToken	string	Non	Le jeton utilisé pour récupérer la page de résultats suivante. Laissez ce paramètre vide pour la première requête. Le jeton pour la page suivante est renvoyé dans la réponse à la première requête.	79aff3eee82242e092899db5f669****
MaximumPageSize	integer	Non	Le nombre maximal de résultats à renvoyer par page. Valeur par défaut : 30. Valeurs valides : 1 à 300.	20
State	string	Non	L'état des travaux à interroger. Valeurs valides : All : tous les travaux. Queuing : les travaux en file d'attente. Analysing : les travaux en cours d'analyse. Fail : les travaux en échec. Success : les travaux réussis.	All
StartOfJobCreatedTimeRange	string	Non	Le début de la plage de temps pour interroger les tâches en fonction de leur heure de création. La date et l'heure sont au format ISO 8601 et en UTC. Le format est AAAA-MM-JJThh:mm:ssZ.	2021-12-22T03:48:05Z
EndOfJobCreatedTimeRange	string	Non	La fin de la plage de temps pour interroger les tâches en fonction de leur heure de création. La date et l'heure sont au format ISO 8601 et en UTC. Le format est AAAA-MM-JJThh:mm:ssZ.	2022-02-14T02:16:07Z
PipelineId	string	Non	L'identifiant de la file d'attente MPS. Pour obtenir l'identifiant de la file d'attente MPS, connectez-vous à la console ApsaraVideo Media Processing et choisissez Paramètres globaux > Files d'attente et rappels MPS.	c5b30b7c0d0e4a0abde1d5f9e751****

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
MediaCensorJobList	object
MediaCensorJob	array<object>	La liste des tâches de modération de contenu.
	array<object>	Les détails d'une tâche de modération de contenu.
CreationTime	string	The time when the job was created.	2021-11-04T07:25:48Z
FinishTime	string	The time when the job was completed.	2021-11-04T07:25:48Z
Suggestion	string	The recommended action. Valid values: pass: The content can be passed. review: The content needs to be manually reviewed. block: The content must be blocked.	pass
CoverImageCensorResults	object
CoverImageCensorResult	array<object>	The list of moderation results for the thumbnails.
	array<object>	The details of the moderation result for a thumbnail.
Object	string	The OSS object of the thumbnail.	test/ai/censor/v2/vme-****.jpg
Location	string	The OSS location of the thumbnail.	oss-cn-shanghai
Bucket	string	The OSS bucket of the thumbnail.	example-Bucket-****
Results	object
Result	array<object>	The moderation results of the job.
	object	The details of a moderation result.
Suggestion	string	The overall moderation result of the job. Valid values: pass: The content can be passed. review: The content needs to be manually reviewed. block: The content must be blocked. Remarque If the moderation result for any category is review, the overall result is review. If the moderation result for any category is block, the overall result is block.	pass
Label	string	The labels of the moderation result. Multiple labels are separated by commas (,). Labels for pornography detection (porn) results: normal: normal sexy: sexy porn: pornographic Labels for terrorism and political content detection (terrorism) results: normal: normal bloody: bloody explosion: explosion outfit: special outfit logo: special logo weapon: weapon politics: political content violence: violence crowd: crowd parade: parade carcrash: car crash flag: flag location: landmark others: others Labels for ad and text violation detection (ad) results: normal: normal ad: other ads politics: text containing political content porn: text containing pornographic content abuse: text containing abusive content terrorism: text containing terrorist content contraband: text containing contraband content spam: other spam npx: skin-disease-like ads qrcode: QR code programCode: miniapp code Labels for undesirable scene detection (live) results: normal: normal meaningless: no content in the image (for example, a black or white screen) PIP: Picture-in-Picture (PiP) smoking: smoking drivelive: live streaming in a car Labels for logo detection (Logo) results: normal: normal TV: contains a controlled logo trademark: contains a trademark	normal
Scene	string	The moderation scenario. porn: pornography detection terrorism: terrorism and political content detection ad: ad and text violation detection live: undesirable scene detection Logo: logo detection	live
Rate	string	The score. Valid values: 0 to 100.	100
State	string	The state of the job.	Success
TitleCensorResult	object	The moderation result for the title.
Suggestion	string	The recommended action. Valid values: pass: The content can be passed. review: The content needs to be manually reviewed. block: The content must be blocked.	block
Label	string	The labels of the moderation result. Multiple labels are separated by commas (,). normal: normal spam: spam ad: advertisement politics: political content terrorism: terrorist content abuse: abuse porn: pornographic content flood: flooding contraband: contraband meaningless: meaningless harmful: undesirable scenarios (This includes worship of money, fan culture, negative emotions, and negative guidance.)	meaningless
Scene	string	The moderation scenario. This is a static field. Value: antispam, which indicates text anti-spam.	antispam
Rate	string	The score.	99.91
Message	string	The error message for a failed job. This parameter is not returned if the job is successful.	The resource operated cannot be found
Input	object	The job input.
Object	string	The OSS object of the input file.	test/ai/censor/test-****.mp4
Location	string	The OSS location of the input file.	oss-cn-shanghai
Bucket	string	The OSS bucket of the input file.	bucket-test-in-****
BarrageCensorResult	object	The moderation result for the live comments.
Suggestion	string	The recommended action. Valid values: pass: The content can be passed. review: The content needs to be manually reviewed. block: The content must be blocked.	pass
Label	string	The category of the moderation result. Multiple categories are separated by commas (,). Valid values: normal: normal spam: spam ad: advertisement politics: political content terrorism: terrorist content abuse: abuse porn: pornographic content flood: flooding contraband: contraband meaningless: meaningless harmful: undesirable scenarios (This includes worship of money, fan culture, negative emotions, and negative guidance.)	normal
Scene	string	The moderation scenario. This is a static field. Value: antispam, which indicates text anti-spam.	antispam
Rate	string	The score.	99.91
DescCensorResult	object	The moderation result for the description.
Suggestion	string	The recommended action. Valid values: pass: The content can be passed. review: The content needs to be manually reviewed. block: The content must be blocked.	pass
Label	string	The category of the moderation result. Multiple categories are separated by commas (,). Valid values: normal: normal spam: spam ad: advertisement politics: political content terrorism: terrorist content abuse: abuse porn: pornographic content flood: flooding contraband: contraband meaningless: meaningless harmful: undesirable scenarios (This includes worship of money, fan culture, negative emotions, and negative guidance.)	ad
Scene	string	The moderation scenario. This is a static field. Value: antispam, which indicates text anti-spam.	antispam
Rate	string	The score.	100
VideoCensorConfig	object	The video moderation configuration.
OutputFile	object	The storage location of the video snapshot results.
Object	string	The output file of the snapshot (an OSS object). Remarque In the example, {Count} is a placeholder. The image objects are named in sequence, such as output00001-**.jpg and `output00002-**.jpg`.	output{Count}.jpg
Location	string	The OSS location of the OSS bucket where the output snapshots are stored.	oss-cn-shanghai
Bucket	string	The OSS bucket where the output snapshots are stored.	test-bucket-****
VideoCensor	string	Indicates whether to moderate the video content. Default value: true. Valid values: true: moderate the video content. false: do not moderate the video content.	true
BizType	string	The moderation template. Default value: common (the default template). Remarque If you do not specify this parameter, the default value `common` is used. If you use a custom moderation template by submitting a ticket, the UID of the template is returned.	common
JobId	string	The ID of the content moderation job.	f8f166eea7a44e9bb0a4aecf9543****
UserData	string	The custom user data.	example userdata ****
Code	string	The error code for a failed job. This parameter is not returned if the job is successful.	InvalidParameter.ResourceNotFound
VensorCensorResult	object	The video moderation result.
VideoTimelines	object
VideoTimeline	array<object>	The moderation results at specific points in time, sorted in ascending order by time.
	array<object>	The details.
Timestamp	string	The position in the video. Format: `hh:mm:ss[.SSS]`.	00:02:59.999
Object	string	The output file of the snapshot (an OSS object). Remarque In the example, {Count} is a placeholder. The image objects are named in sequence, such as output00001-**.jpg and `output00002-**.jpg`.	output{Count}.jpg
CensorResults	object
CensorResult	array<object>	The labels and scores of different types of moderation results.
	object	The details.
Suggestion	string	The recommended action. Valid values: pass: The content can be passed. review: The content needs to be manually reviewed. block: The content must be blocked.	block
Label	string	The categories of the moderation result. Multiple categories are separated by commas (,). Valid values: Labels for pornography detection (porn) results: porn: pornographic sexy: sexy normal: normal Labels for terrorism and political content detection (terrorism) results: normal: normal bloody: bloody explosion: explosion outfit: special outfit logo: special logo weapon: weapon politics: political content violence: violence crowd: crowd parade: parade carcrash: car crash flag: flag location: landmark others: others Labels for ad detection (ad) results: normal: normal ad: other ads politics: text containing political content porn: text containing pornographic content abuse: text containing abusive content terrorism: text containing terrorist content contraband: text containing contraband content spam: other spam npx: skin-disease-like ads qrcode: QR code programCode: miniapp code Labels for undesirable scene detection (live) results: normal: normal meaningless: no content in the image (for example, a black or white screen) PIP: Picture-in-Picture (PiP) smoking: smoking drivelive: live streaming in a car Labels for logo detection (logo) results: normal: normal TV: contains a controlled logo trademark: contains a trademark	normal
Scene	string	The moderation scenario. porn: pornography detection terrorism: terrorism and political content detection ad: ad and text violation detection live: undesirable scene detection logo: logo detection	pron
Rate	string	The score.	99.99
NextPageToken	string	The token for the next page.	ea04afcca7cd4e80b9ece8fbb251****
CensorResults	object
CensorResult	array<object>	A collection of moderation results, which contains the summary information for various scenarios, such as pornography, terrorism, and political content.
	object	The details of the moderation result.
Suggestion	string	The recommended action. Valid values: pass: The content can be passed. review: The content needs to be manually reviewed. block: The content must be blocked.	review
Label	string	The categories of the moderation result. Multiple categories are separated by commas (,). Valid values: Labels for pornography detection (porn) results: porn: pornographic sexy: sexy normal: normal Labels for terrorism and political content detection (terrorism) results: normal: normal bloody: bloody explosion: explosion outfit: special outfit logo: special logo weapon: weapon politics: political content violence: violence crowd: crowd parade: parade carcrash: car crash flag: flag location: landmark others: others Labels for ad detection (ad) results: normal: normal ad: other ads politics: text containing political content porn: text containing pornographic content abuse: text containing abusive content terrorism: text containing terrorist content contraband: text containing contraband content spam: other spam npx: skin-disease-like ads qrcode: QR code programCode: miniapp code Labels for undesirable scene detection (live) results: normal: normal meaningless: no content in the image (for example, a black or white screen) PIP: Picture-in-Picture (PiP) smoking: smoking drivelive: live streaming in a car Labels for logo detection (logo) results: normal: normal TV: contains a controlled logo trademark: contains a trademark	meaningless
Scene	string	The moderation scenario. porn: pornography detection terrorism: terrorism and political content detection ad: ad and text violation detection live: undesirable scene detection logo: logo detection	terrorism
Rate	string	The score.	100
AudioCensorResult	object	The audio moderation result.
Suggestion	string	The recommended action. Valid values: pass: The content can be passed. review: The content needs to be manually reviewed. block: The content must be blocked.	pass
Label	string	The category of the detection result. Valid values: normal: normal text spam: spam ad: advertisement politics: political content terrorism: terrorist content abuse: abuse porn: pornographic content flood: flooding contraband: contraband meaningless: meaningless harmful: undesirable scenarios (This includes worship of money, fan culture, negative emotions, and negative guidance.)	normal
PipelineId	string	The ID of the MPS queue.	c5b30b7c0d0e4a0abde1d5f9e751****
RequestId	string	L'identifiant de la requête.	D1D5C080-8E2F-5030-8AB4-13092F17631B
NextPageToken	string	Le jeton pour la page suivante. Il s'agit d'un identifiant universel unique (UUID) de 32 bits. Ce paramètre est renvoyé lorsque les résultats de la requête s'étendent sur plusieurs pages. La valeur de ce paramètre est mise à jour pour chaque requête.	9b1a42bc6e8d46e6a1383b7e7f01****
NonExistIds	object
String	array	La liste des identifiants de tâche qui n'existent pas. Ce paramètre n'est pas renvoyé si tous les identifiants de tâche spécifiés existent.
	string	L'identifiant de la tâche.	78dc866518b843259669df58ed30****

Exemples

JSON format

{
  "MediaCensorJobList": {
    "MediaCensorJob": [
      {
        "CreationTime": "2021-11-04T07:25:48Z",
        "FinishTime": "2021-11-04T07:25:48Z",
        "Suggestion": "pass",
        "CoverImageCensorResults": {
          "CoverImageCensorResult": [
            {
              "Object": "test/ai/censor/v2/vme-****.jpg",
              "Location": "oss-cn-shanghai",
              "Bucket": "example-Bucket-****",
              "Results": {
                "Result": [
                  {
                    "Suggestion": "pass",
                    "Label": "normal",
                    "Scene": "live",
                    "Rate": "100"
                  }
                ]
              }
            }
          ]
        },
        "State": "Success",
        "TitleCensorResult": {
          "Suggestion": "block",
          "Label": "meaningless",
          "Scene": "antispam",
          "Rate": "99.91"
        },
        "Message": "The resource operated cannot be found",
        "Input": {
          "Object": "test/ai/censor/test-****.mp4",
          "Location": "oss-cn-shanghai",
          "Bucket": "bucket-test-in-****"
        },
        "BarrageCensorResult": {
          "Suggestion": "pass",
          "Label": "normal",
          "Scene": "antispam",
          "Rate": "99.91"
        },
        "DescCensorResult": {
          "Suggestion": "pass",
          "Label": "ad",
          "Scene": "antispam",
          "Rate": "100"
        },
        "VideoCensorConfig": {
          "OutputFile": {
            "Object": "output{Count}.jpg",
            "Location": "oss-cn-shanghai",
            "Bucket": "test-bucket-****"
          },
          "VideoCensor": "true",
          "BizType": "common"
        },
        "JobId": "f8f166eea7a44e9bb0a4aecf9543****",
        "UserData": "example userdata ****",
        "Code": "InvalidParameter.ResourceNotFound",
        "VensorCensorResult": {
          "VideoTimelines": {
            "VideoTimeline": [
              {
                "Timestamp": "00:02:59.999",
                "Object": "output{Count}.jpg",
                "CensorResults": {
                  "CensorResult": [
                    {
                      "Suggestion": "block",
                      "Label": "normal",
                      "Scene": "pron",
                      "Rate": "99.99"
                    }
                  ]
                }
              }
            ]
          },
          "NextPageToken": "ea04afcca7cd4e80b9ece8fbb251****",
          "CensorResults": {
            "CensorResult": [
              {
                "Suggestion": "review",
                "Label": "meaningless",
                "Scene": "terrorism",
                "Rate": "100"
              }
            ]
          }
        },
        "AudioCensorResult": {
          "Suggestion": "pass",
          "Label": "normal"
        },
        "PipelineId": "c5b30b7c0d0e4a0abde1d5f9e751****"
      }
    ]
  },
  "RequestId": "D1D5C080-8E2F-5030-8AB4-13092F17631B",
  "NextPageToken": "9b1a42bc6e8d46e6a1383b7e7f01****",
  "NonExistIds": {
    "String": [
      "78dc866518b843259669df58ed30****"
    ]
  }
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.