CreateVideoModerationTask - - Centre de documentation Alibaba Cloud

Détecte les menaces ou les contenus non conformes dans les vidéos. Cette opération peut être utilisée dans des scénarios tels que la détection de pornographie, de terrorisme et de contenus politiquement sensibles, la détection de violations textuelles et visuelles, la détection de scènes indésirables et la détection de logos.

Description de l'opération

Avant d'utiliser cette opération, assurez-vous de bien comprendre les méthodes de facturation et la tarification d'Intelligent Media Management.

Important
Le délai d'exécution des tâches asynchrones n'est pas garanti.
Les résultats de détection sont renvoyés dans un message de notification asynchrone. Le champ Suggestion dans le message de notification asynchrone peut prendre les valeurs suivantes :
- pass : La vidéo a passé l'examen. Aucun contenu non conforme n'a été détecté.
- block : La vidéo doit être bloquée. Cette valeur est renvoyée lorsqu'un contenu non conforme est détecté. Le champ Categories indique la catégorie du contenu non conforme. Pour plus d'informations sur les catégories, consultez Résultats de détection de Content Moderation.
- review : La vidéo nécessite un examen manuel. Une fois l'examen manuel terminé, un autre message de notification asynchrone est envoyé avec le résultat.
Exigences relatives aux instantanés vidéo :
- Les URL des images vidéo prennent en charge les protocoles HTTP et HTTPS.
- Formats d'images vidéo pris en charge : PNG, JPG, JPEG, BMP, GIF et WEBP.
- La taille d'une image vidéo ne peut pas dépasser 10 Mo.
- La résolution recommandée pour les images vidéo est d'au moins 256 × 256 pixels. Une résolution plus faible peut affecter la précision de la détection.
- Le temps de réponse de l'opération de détection vidéo dépend du temps de téléchargement des images vidéo. Assurez-vous que le service de stockage de vos images vidéo est stable et fiable. Nous vous recommandons d'utiliser Alibaba Cloud Object Storage Service (OSS) ou de mettre en cache les images avec Alibaba Cloud CDN.
Il s'agit d'une opération asynchrone. Une fois une tâche créée, les informations de la tâche ne sont conservées que pendant 7 jours. Passé ce délai, les informations ne peuvent plus être récupérées. Vous pouvez appeler l'opération GetTask ou ListTasks pour interroger les informations de la tâche à l'aide du TaskId renvoyé. Vous pouvez également définir le paramètre Notification pour recevoir les informations de la tâche via des messages de notification asynchrones.

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.

imm:CreateVideoModerationTask

create

*Project

acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
ProjectName	string	Oui	Le nom du projet. Pour plus d'informations sur la façon d'obtenir le nom du projet, consultez Créer un projet.	immtest
UserData	string	Non	Informations personnalisées renvoyées dans le message de notification asynchrone. Utilisez ces informations pour associer le message de notification à votre système interne. La longueur maximale est de 2 048 octets.	{"ID": "user1","Name": "test-user1","Avatar": "http://example.com?id=user1"}
SourceURI	string	Oui	L'URI OSS de la vidéo. L'URI OSS doit respecter le format oss://${Bucket}/${Object}. `${Bucket}` est le nom du compartiment OSS dans la même région que le projet. `${Object}` est le chemin complet du fichier, y compris l'extension du nom de fichier.	oss://test-bucket/test-object
Tags	object	Non	Balises personnalisées utilisées pour rechercher des tâches.	{"test": "val1"}
CredentialConfig	CredentialConfig	Non	La configuration d'autorisation chaînée. Ce paramètre est facultatif. Pour plus d'informations, consultez Utiliser l'autorisation chaînée pour accéder aux ressources d'autres entités.
Scenes	array	Non	Les scénarios de détection vidéo.
	string	Non	Le scénario de détection vidéo. Valeurs valides : porn : Détection de pornographie. terrorism : Détection de terrorisme et de contenus politiquement sensibles. live : Détection de scènes indésirables. logo : Détection de logos. ad : Détection de violations textuelles et visuelles. Remarque Si vous ne spécifiez pas de scénario de détection, les scénarios `porn`, `terrorism` et `ad` sont utilisés par défaut. Valeurs valides : ad : Détection de violations textuelles et visuelles. terrorism : Détection de terrorisme et de contenus politiquement sensibles. logo : Détection de logos. live : Détection de scènes indésirables. porn : Détection de pornographie.	porn
Interval	integer	Non	L'intervalle pour les instantanés vidéo, en secondes. La valeur peut être un entier compris entre 1 et 600. La valeur par défaut est 1.	1
MaxFrames	integer	Non	Le nombre maximal d'images pouvant être capturées pour cette tâche de détection. La valeur peut être un entier compris entre 5 et 3 600. La valeur par défaut est 200.	200
Notification	Notification	Non	La configuration des notifications. Pour connaître le format des messages de notification asynchrones, consultez la section d'index des métadonnées dans Format des messages de notification asynchrones.

Éléments de réponse

Élément	Type	Description	Exemple
	object	La structure de la réponse.
RequestId	string	L'identifiant de la requête.	1B3D5E0A-D8B8-4DA0-8127-ED32C851****
TaskId	string	L'identifiant de la tâche.	VideoModeration-9442a216-4691-4a48-846d-76daccaf*****
EventId	string	L'identifiant de l'événement.	2E6-1I0FGn0zFnl5AflRfhzClma*****

Exemples

JSON format

{
  "RequestId": "1B3D5E0A-D8B8-4DA0-8127-ED32C851****",
  "TaskId": "VideoModeration-9442a216-4691-4a48-846d-76daccaf*****",
  "EventId": "2E6-1I0FGn0zFnl5AflRfhzClma*****"
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.