Présentation des API - Intelligent Media Management - Centre de documentation Alibaba Cloud

Normes API et SDK multilingues prédéfinis

L'OpenAPI de ce produit (imm/2020-09-30) utilise le style de signature RPC. Des SDK sont disponibles pour les langages de programmation courants. Les développeurs peuvent télécharger le SDK pour appeler directement l'OpenAPI de ce produit, sans se soucier des détails techniques. Si le SDK existant ne répond pas à vos besoins, utilisez le mécanisme de signature pour une intégration par auto-signature. L'auto-signature étant particulièrement complexe, comptez environ 5 jours ouvrables. Nous vous recommandons donc de rejoindre notre groupe d'assistance DingTalk (147535001692) pour bénéficier d'un accompagnement expert lors de l'intégration.

Avant d'utiliser l'API, préparez votre compte d'identité et votre clé d'accès (AccessKey) afin d'accéder efficacement à l'API via des outils clients (tels que SDK et CLI). Pour plus d'informations, consultez Obtenir un AccessKey.

Scénarios de signature personnalisée

Si votre scénario métier présente des exigences particulières et nécessite une intégration par auto-signature, consultez d'abord notre équipe de support technique (groupe d'assistance DingTalk : 147535001692) pour obtenir un accompagnement professionnel et garantir une intégration efficace.

Préparation du compte et de la sécurité

Les comptes Alibaba Cloud disposent de permissions administratives complètes sur l'ensemble des ressources. En cas de compromission d'un AccessKey, toutes les ressources associées sont exposées à un risque d'accès non autorisé. Pour garantir la sécurité, créez un utilisateur RAM disposant uniquement de permissions d'accès API et configurez son AccessKey. Appliquez ensuite des politiques RAM selon le principe du moindre privilège (PoLP). N'utilisez le compte Alibaba Cloud que dans les scénarios spécifiques où ses permissions sont explicitement requises.

Régions de service

API	Titre	Description
ListRegions	Liste des régions prenant en charge le service IMM.	Obtient la liste des régions.

Gestion des projets

API	Titre	Description
CreateProject	Créer un projet.	Crée un projet.
UpdateProject	Mise à jour d'un projet.	Met à jour les informations d'un projet créé.
GetProject	Consultation des informations du projet.	Consulte les informations d'un projet spécifié, notamment les informations de base et les statistiques relatives aux jeux de données et aux fichiers.
ListProjects	Consulte toutes les informations des projets.	Consulte les informations de tous les projets, y compris les informations de base et les statistiques relatives aux jeux de données et aux fichiers.
DeleteProject	DeleteProject.	Supprime un projet.

Gestion des métadonnées

API	Titre	Description
Gestion des jeux de données	Gestion des jeux de données
CreateDataset	Créer un jeu de données.	Crée un jeu de données.
UpdateDataset	Mettre à jour un jeu de données.	Met à jour les informations d'un jeu de données.
GetDataset	GetDataset.	Consulte un jeu de données.
ListDatasets	ListDatasets.	Consulte une liste de jeux de données. Vous pouvez interroger la liste par préfixe de jeu de données.
DeleteDataset	Supprimer un jeu de données.	Supprime un jeu de données.
Indexation des métadonnées	Indexation des métadonnées
IndexFileMeta	IndexFileMeta.	Effectue un traitement des données sur les fichiers d'entrée pour des tâches telles que la détection de labels, la détection de visages et la détection d'emplacements. Cette opération extrait les métadonnées des objets et crée un index, permettant ainsi de récupérer des données à partir d'un jeu de données.
BatchIndexFileMeta	BatchIndexFileMeta.	Cette opération effectue une indexation par lots des métadonnées des objets en traitant les fichiers d'entrée pour des tâches telles que la détection de labels, la détection de visages et la détection de localisation. Les métadonnées des objets sont ensuite indexées dans un jeu de données pour prendre en charge diverses méthodes de récupération de données.
UpdateFileMeta	UpdateFileMeta.	Met à jour les métadonnées partielles des fichiers indexés dans un jeu de données.
BatchUpdateFileMeta	BatchUpdateFileMeta	Met à jour certains éléments de métadonnées des fichiers indexés dans un jeu de données.
GetFileMeta	GetFileMeta.	Consulte les métadonnées d'un fichier dont les métadonnées sont indexées dans le jeu de données.
BatchGetFileMeta	BatchGetFileMeta.	Consulte les métadonnées de plusieurs objets ou fichiers dans le jeu de données spécifié.
DeleteFileMeta	DeleteFileMeta.	Supprime les métadonnées d'un fichier d'un jeu de données.
BatchDeleteFileMeta	BatchDeleteFileMeta.	Supprime les métadonnées de plusieurs fichiers d'un jeu de données.
Requêtes et statistiques	Requêtes et statistiques
SimpleQuery	SimpleQuery.	Consulte les fichiers d'un jeu de données en effectuant une opération de requête simple. L'opération prend en charge les expressions logiques.
SemanticQuery	SemanticQuery.	Consulte les métadonnées d'un jeu de données en saisissant du langage naturel.
FuzzyQuery	FuzzyQuery.	Consulte les métadonnées de fichier extraites, y compris le nom du fichier, les étiquettes, le chemin, les balises personnalisées et d'autres champs. Si la valeur d'un champ de métadonnées d'un fichier correspond à la chaîne spécifiée, les métadonnées du fichier sont renvoyées.
Gestion intelligente	Gestion intelligente
Clustering facial	Clustering facial
CreateFigureClusteringTask	CreateFigureClusteringTask.	Crée une tâche de regroupement de visages. Cette tâche utilise un algorithme intelligent pour regrouper les visages de différentes personnes dans les images indexées dans un jeu de données.
CreateFigureClustersMergingTask	CreateFigureClustersMergingTask.	Fusionne deux groupes de clustering de figures ou plus en un seul groupe de clustering de figures.
GetFigureCluster	GetFigureCluster	Obtient les informations de base sur le regroupement de visages, notamment l'heure de création, le nombre d'images et la couverture.
QueryFigureClusters	QueryFigureClusters.	Consulte les groupes de visages en fonction de conditions données.
BatchGetFigureCluster	BatchGetFigureCluster.	Consulte les clusters de visages.
UpdateFigureCluster	UpdateFigureCluster.	Met à jour les informations relatives à un cluster de visages, telles que le nom du cluster et les balises.
SearchImageFigureCluster	SearchImageFigureCluster.	Consulte les clusters de visages qui contiennent un visage spécifique dans une image. Chaque cluster de visages contient des informations telles que les boîtes englobantes et la similarité.
CreateFacesSearchingTask	CreateFacesSearchingTask.	Recherche dans un ensemble de médias les N images les plus similaires à une image ou à un identifiant de visage spécifié. L'opération renvoie les identifiants de visage correspondants et les boîtes englobantes, triés par similarité par ordre décroissant.
Clustering spatio-temporel	Clustering spatio-temporel
CreateLocationDateClusteringTask	CreateLocationDateClusteringTask.	La fonction de clustering spatio-temporel classe les fichiers d'un jeu de données en fonction de leur date et de leur emplacement. Cette fonction s'applique aux fichiers indexés, tels que les images et les vidéos, qui contiennent des données sur l'heure et le lieu de prise de vue. Ces classifications peuvent représenter le contenu d'un voyage d'un utilisateur, lorsque les fichiers partagent des horodatages et des emplacements similaires. Elles peuvent également représenter du contenu capturé dans les différents lieux de résidence ou de travail d'un utilisateur. L'analyse des emplacements et des plages horaires de ces classifications permet de catégoriser les fichiers multimédias, de créer des compilations des meilleurs moments et de générer des récits photo et vidéo.
QueryLocationDateClusters	QueryLocationDateClusters.	Consulte la liste des clusters spatio-temporels en fonction des conditions spécifiées.
UpdateLocationDateCluster	UpdateLocationDateCluster.	Met à jour un cluster spatio-temporel.
DeleteLocationDateCluster	DeleteLocationDateCluster.	Supprime un cluster spatio-temporel.
Récits	Récits
CreateStory	CreateStory.	Crée une histoire.
QueryStories	QueryStories.	Consulte les histoires en fonction des conditions spécifiées.
GetStory	GetStory.	Consulte une histoire.
CreateCustomizedStory	CreateCustomizedStory.	Crée une histoire à partir des images et vidéos spécifiées.
UpdateStory	UpdateStory.	Met à jour les informations relatives à une histoire, telles que le nom de l'histoire et l'image de couverture.
AddStoryFiles	Ajout d'objets à une histoire.	Ajoute des objets à une histoire.
RemoveStoryFiles	RemoveStoryFiles.	Supprime des fichiers d'une histoire.
DeleteStory	DeleteStory.	Supprime une histoire.
Clustering d'images	Clustering d'images
CreateSimilarImageClusteringTask	CreateSimilarImageClusteringTask.	La fonctionnalité de clustering d'images similaires regroupe les images que vous avez indexées dans un jeu de données en clusters basés sur la similarité visuelle. Cette fonctionnalité est utile pour des scénarios tels que la déduplication d'images ou la sélection des meilleures prises de vue. Par exemple, vous pouvez l'utiliser pour filtrer les photos en rafale dans un album.
QuerySimilarImageClusters	QuerySimilarImageClusters.	Consulte la liste des clusters d'images similaires.
Liaison de données	Liaison de données
CreateBinding	CreateBinding	Crée une liaison entre un jeu de données et un compartiment Object Storage Service (OSS). Cela permet la synchronisation automatique des données incrémentielles et complètes, ainsi que leur indexation.
GetBinding	GetBinding.	Consulte la relation de liaison entre un jeu de données spécifique et un compartiment Object Storage Service (OSS).
ListBindings	Consultation de la liste des liaisons.	Consulte la liste des liaisons entre les jeux de données et les buckets Object Storage Service (OSS).
DeleteBinding	DeleteBinding	Supprime la liaison entre un jeu de données et un bucket Object Storage Service (OSS).
AttachOSSBucket	AttachOSSBucket	Associe un compartiment Object Storage Service (OSS) au projet spécifié. Cette association vous permet d'utiliser les fonctionnalités d'IMM à l'aide du paramètre x-oss-process.
DetachOSSBucket	DetachOSSBucket.	Dissocie un bucket Object Storage Service (OSS) du projet correspondant.
GetOSSBucketAttachment	Informations de liaison du bucket OSS.	Obtient le nom d'un projet associé à un bucket OSS spécifié dans la même région.

Traitement des images

API	Titre	Description
EncodeBlindWatermark	EncodeBlindWatermark.	Intègre des informations textuelles spécifiques dans une image sous forme de filigranes. Ces filigranes sont visuellement imperceptibles et n'affectent ni l'esthétique de l'image ni l'intégrité des données d'origine. Les filigranes peuvent être extraits à l'aide de l'opération CreateDecodeBlindWatermarkTask.
CreateDecodeBlindWatermarkTask	CreateDecodeBlindWatermarkTask.	Extrait un filigrane invisible.
GetDecodeBlindWatermarkResult	Résultat de la tâche d'extraction de filigrane invisible.	Obtient le résultat d'une tâche d'extraction de filigrane invisible pour une image.
DetectImageLabels	DetectImageLabels.	Détecte les informations de scène, d'objet et d'événement dans une image. Les informations de scène incluent les paysages naturels, la vie quotidienne et les catastrophes. Les informations d'événement incluent les concours de talents, les événements de bureau, les spectacles et les événements de production. Les informations d'objet incluent la vaisselle, les appareils électroniques, les meubles et les transports. L'opération DetectImageLabels prend en charge plus de 30 catégories différentes et des milliers de labels.
DetectImageScore	DetectImageScore.	Calcule le score de qualité esthétique d'une image en fonction de métriques telles que la composition, la luminosité, le contraste, la couleur et la résolution. L'opération renvoie un score compris entre 0 et 1. Un score plus élevé indique une meilleure qualité d'image.
DetectImageCodes	DetectImageCodes.	Détecte les codes-barres et les codes QR dans une image.
DetectImageFaces	DetectImageFaces.	Détecte les visages à partir d'une image, y compris les informations sur les limites du visage, les attributs et la qualité. Les informations sur les limites incluent la distance entre la coordonnée y du sommet et le bord supérieur (Top), la distance entre la coordonnée x du sommet et le bord gauche (Left), la hauteur (Height) et la largeur (Width). Les attributs du visage incluent l'âge (Age), l'écart type de l'âge (AgeSD), le genre (Gender), l'émotion (Emotion), l'ouverture de la bouche (Mouth), la barbe (Beard), le port d'un chapeau (Hat), le port d'un masque (Mask), le port de lunettes (Glasses), l'orientation de la tête (HeadPose), l'attractivité (Attractive) et les niveaux de confiance pour les attributs précédents. Les informations de qualité incluent le score de qualité du visage (FaceQuality) et la résolution du visage (Sharpness).
DetectImageCropping	Détecte les zones de recadrage d'image optimales en utilisant les capacités du modèle d'IA.	Détecte les zones de recadrage visuellement optimales dans une image à un rapport d'aspect spécifié en utilisant les capacités du modèle d'IA.
AddImageMosaic	AddImageMosaic.	Ajoute des mosaïques, des flous gaussiens ou des formes de couleur unie pour flouter une ou plusieurs zones d'une image afin de protéger la vie privée, et enregistre l'image de sortie dans le chemin spécifié dans Object Storage Service (OSS).
CreateImageToPDFTask	CreateImageToPDFTask.	Convertit plusieurs images en un seul fichier PDF et enregistre le fichier en tant qu'objet OSS spécifié.
CreateImageSplicingTask	CreateImageSplicingTask.	Assemble plusieurs images en une seule image selon des règles spécifiées et enregistre le résultat dans un objet OSS spécifié.
CompareImageFaces	CompareImageFaces.	Compare la similitude des plus grands visages de deux images. Le plus grand visage correspond au plus grand cadre de visage détecté dans une image après la détection des visages.
DetectImageBodies	DetectImageBodies.	Détecte les informations relatives au corps humain, telles que le niveau de confiance et la boîte englobante du corps, dans une image.
DetectImageCars	DetectImageCars.	Détecte les données de contour, les attributs et les informations de plaque d'immatriculation des véhicules dans une image. Les attributs du véhicule incluent la couleur du véhicule (CarColor) et le type de véhicule (CarType). Les informations de plaque d'immatriculation incluent le contenu de reconnaissance (Content) et le cadre de la plaque (Boundary).
DetectImageTexts	DetectImageTexts.	Reconnaît et extrait le contenu textuel d'une image.

Traitement des médias

API	Titre	Description
CreateMediaConvertTask	Créer une tâche de transcodage de médias.	Crée une tâche de transcodage de médias asynchrone. Cette tâche traite les fichiers audio et vidéo pour le transcodage de médias, la concaténation de médias, la capture d'images vidéo et la génération de GIF animés.
DetectMediaMeta	Récupération des métadonnées de fichier multimédia.	Obtient les métadonnées d'un fichier multimédia, y compris les informations sur le format multimédia et les informations sur les flux multimédias.
CreateVideoLabelClassificationTask	CreateVideoLabelClassificationTask.	Détecte les labels pour les scénarios, les objets et les événements dans le contenu vidéo. Cette fonctionnalité prend en charge plus de 30 catégories et des milliers de labels. Les labels de scénario incluent les paysages naturels, les scènes de la vie courante et les scènes de catastrophe. Les labels d'événement incluent les émissions de talents, le travail de bureau, les spectacles et la production. Les labels d'objet incluent la vaisselle, les produits électroniques, les meubles et les véhicules.
GetVideoLabelClassificationResult	Obtention de la tâche de détection d'étiquettes vidéo.	Obtient le résultat d'une tâche de détection d'étiquettes vidéo.
GenerateVideoPlaylist	Génération d'une liste de lecture de transcodage juste à temps.	Crée une liste de lecture de transcodage juste à temps qui génère un fichier M3U8 à partir d'un fichier vidéo, permet une lecture instantanée après la génération de la liste de lecture et effectue un transcodage à la demande en fonction de la progression de la lecture. Par rapport au transcodage hors ligne, cette opération réduit considérablement le temps d'attente du transcodage et diminue fortement les coûts de transcodage et de stockage.
CreateHighlightTask	Créer une tâche de découpage de moments forts vidéo.	Crée une tâche de moments forts vidéo. Cette fonctionnalité est en préversion sur invitation.

Traitement des documents

API	Titre	Description
GenerateWebofficeToken	Obtention des identifiants WebOffice.	Obtient les identifiants de prévisualisation et de modification d'un document.
RefreshWebofficeToken	Actualiser un jeton Weboffice.	Actualise un jeton d'accès Weboffice. Un jeton d'accès Weboffice est valide pendant 30 minutes. Une fois expiré, vous ne pouvez plus accéder à Weboffice. Pour continuer à accéder à Weboffice, appelez cette opération pour actualiser le jeton d'accès Weboffice et obtenir un nouveau jeton également valide pendant 30 minutes.
CreateOfficeConversionTask	CreateOfficeConversionTask.	Crée une tâche de conversion de document qui convertit des documents, tels que des fichiers Word, PowerPoint, Excel et PDF, stockés dans Object Storage Service (OSS) en images, fichiers texte ou fichiers PDF.
ExtractDocumentText	Extraction du texte d'un document.	Extrait le texte d'un document.

Traitement des fichiers

API	Titre	Description
Compression et décompression	Compression et décompression
CreateFileCompressionTask	CreateFileCompressionTask.	Télécharge des packages.
CreateArchiveFileInspectionTask	CreateArchiveFileInspectionTask.	Crée une tâche pour inspecter un fichier compressé et récupérer la liste de son contenu sans décompresser le fichier.
CreateFileUncompressionTask	CreateFileUncompressionTask.	Une tâche de décompression de fichiers permet de décompresser des fichiers spécifiques ou l'intégralité d'une archive compressée vers un emplacement spécifié. Les formats pris en charge sont Zip, RAR et 7z.
Compression de nuages de points	Compression de nuages de points
CreateCompressPointCloudTask	Créer une tâche de compression de nuage de points.	Compresse les données de nuage de points stockées dans Object Storage Service (OSS) pour réduire la transmission de données sur le réseau.

Sécurité du contenu

API	Titre	Description
DetectTextAnomaly	DetectTextAnomaly	Détecte si un texte spécifié contient des anomalies, telles que de la pornographie, des publicités, une quantité excessive de contenu indésirable, du contenu politiquement sensible et des propos abusifs.
CreateImageModerationTask	CreateImageModerationTask.	Détecte les contenus non conformes dans les images, tels que la pornographie, le terrorisme, les scènes indésirables, les logos et les violations de texte sur image.
CreateVideoModerationTask	CreateVideoModerationTask.	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.
GetImageModerationResult	Obtention d'une tâche de modération de contenu d'image.	Obtient une tâche de modération de contenu d'image.
GetVideoModerationResult	Récupération d'une tâche de modération de contenu vidéo.	Obtient une tâche de modération de contenu vidéo.

Gestion des tâches

API	Titre	Description
GetTask	Récupérer les informations de la tâche.	Consulte les informations relatives à une tâche asynchrone spécifiée. Intelligent Media Management (IMM) prend en charge diverses capacités de traitement de données asynchrones, chacune avec sa propre opération de création de tâche, telle que CreateFigureClusteringTask pour la création de tâches de clustering de figures et CreateFileCompressionTask pour la création de tâches de compression de fichiers. Cette opération est une opération à usage général qui vous permet de consulter les détails d'une tâche asynchrone par identifiant et type de tâche.
ListTasks	ListTasks.	Répertorie les tâches en fonction de conditions spécifiques, telles que la plage de temps et les balises.
Déclencheurs	Déclencheurs
CreateTrigger	CreateTrigger.	Crée un déclencheur pour démarrer le traitement des données dans Intelligent Media Management (IMM). Le déclencheur est activé par des sources d'événements, telles qu'Object Storage Service (OSS), et utilise des modèles de traitement des données pour traiter des fichiers multimédias, tels que des images, des vidéos et des documents.
SuspendTrigger	SuspendTrigger.	Suspend un déclencheur en cours d'exécution.
ResumeTrigger	ResumeTrigger.	Reprend un déclencheur à l'état Suspendu ou Échec.
UpdateTrigger	UpdateTrigger	Met à jour les informations d'un déclencheur, telles que la source de données d'entrée, les paramètres de traitement des données et les balises.
GetTrigger	Informations sur le déclencheur.	Consulte les informations relatives à un déclencheur.
ListTriggers	ListTriggers.	Consulte les déclencheurs par balise ou par état.
DeleteTrigger	DeleteTrigger.	Supprime un déclencheur.
Traitement par lots	Traitement par lots
CreateBatch	CreateBatch.	Crée une tâche de traitement par lot qui exécute des opérations spécifiées, telles que le transcodage et la conversion de format, sur plusieurs fichiers existants.
SuspendBatch	SuspendBatch.	Suspend une tâche de traitement par lots.
ResumeBatch	ResumeBatch.	Reprend une tâche de traitement par lot à l'état Suspendu ou Échoué.
UpdateBatch	UpdateBatch.	Met à jour les informations d'une tâche de traitement par lots, telles que la configuration de la source de données, la configuration du traitement des données et les balises.
ListBatches	ListBatches.	Consulte les tâches de traitement par lots. Vous pouvez interroger les tâches de traitement par lots en fonction de conditions telles que les balises de tâche et l'état. Les résultats peuvent être triés.
GetBatch	Obtenir le lot.	Consulte les informations relatives à une tâche de traitement par lots.
DeleteBatch	DeleteBatch.	Supprime une tâche de traitement par lots.

Autres

API	Titre	Description
ContextualAnswer	API de questions-réponses dans l'assistant IA.	Phase II de l'assistant IA, API de questions-réponses.
ContextualRetrieval	ContextualRetrieval.	Obtient des documents sémantiquement similaires. L'opération est conçue pour les conversations multi-tours et peut traiter les saisies de messages dans les conversations historiques. L'opération renvoie des résultats fortement liés à la conversation actuelle en s'appuyant sur une compréhension approfondie du contenu contextuel. Elle offre une récupération d'informations cohérente et efficace dans les conversations multi-tours.
ListAttachedOSSBuckets	Liste des relations d'association des buckets OSS.	Répertorie les attachements associés.