Descripción general de la API - Intelligent Media Management - Centro de documentación de Alibaba Cloud

Estándares de API y SDK preconfigurados multilenguaje

La OpenAPI de este producto (imm/2020-09-30) utiliza el estilo de firma RPC. Se han encapsulado SDK para los lenguajes de programación más comunes con el fin de facilitar el desarrollo. Los desarrolladores pueden descargar el SDK para invocar directamente la OpenAPI de este producto sin preocuparse por los detalles técnicos. Si el SDK existente no satisface sus necesidades, utilice el mecanismo de firma para una integración con autofirma. Dado que los detalles de la autofirma son muy complejos, este proceso puede tardar alrededor de 5 días hábiles. Por lo tanto, se recomienda unirse a nuestro grupo de servicio de DingTalk (147535001692) para llevar a cabo la integración de firmas bajo la guía de expertos.

Antes de usar la API, prepare su cuenta de identidad y su clave de acceso (AccessKey) para acceder eficazmente a la API mediante herramientas cliente (como SDK y CLI). Para obtener más información, consulte Obtener un AccessKey.

Escenarios de firma personalizada

Si su escenario empresarial tiene requisitos especiales y necesita integrar la API mediante autofirma, se recomienda consultar primero a nuestro equipo de soporte técnico (grupo de servicio de DingTalk: 147535001692) para obtener orientación profesional y garantizar una integración eficiente.

Preparación de cuenta y seguridad

Las cuentas de Alibaba Cloud tienen permisos administrativos completos sobre todos los recursos. Si un AccessKey se ve comprometido, todos los recursos asociados corren el riesgo de sufrir accesos no autorizados. Para garantizar la seguridad, se recomienda crear un RAM user con permisos de acceso exclusivos a la API y configurar su AccessKey, además de establecer directivas de RAM basadas en el principio de menor privilegio (PoLP). Utilice la cuenta de Alibaba Cloud únicamente en escenarios específicos donde se requieran explícitamente sus permisos.

Regiones de servicio

API	Título	Descripción
ListRegions	Lista de regiones que admiten el servicio IMM.	Obtiene la lista de regiones.

Gestión de proyectos

API	Título	Descripción
CreateProject	Crear un proyecto.	Crea un proyecto.
UpdateProject	Actualizar un proyecto.	Actualiza la información de un proyecto creado.
GetProject	Consultar información del proyecto.	Consulta información sobre un proyecto especificado, incluida la información básica y las estadísticas relacionadas con conjuntos de datos y archivos.
ListProjects	Consultar toda la información de los proyectos.	Consulta información sobre todos los proyectos, incluida la información básica y las estadísticas relacionadas con conjuntos de datos y archivos.
DeleteProject	Eliminar un proyecto.	Elimina un proyecto.

Gestión de metadatos

API	Título	Descripción
Gestión de conjuntos de datos	Gestión de conjuntos de datos
CreateDataset	Crear un conjunto de datos.	Crea un conjunto de datos.
UpdateDataset	Actualizar un conjunto de datos.	Actualiza la información de un conjunto de datos.
GetDataset	GetDataset.	Consulta un conjunto de datos.
ListDatasets	ListDatasets.	Consulta una lista de conjuntos de datos. Puede consultar la lista por prefijo del conjunto de datos.
DeleteDataset	DeleteDataset	Deletes a dataset.
Indexación de metadatos	Indexación de metadatos
IndexFileMeta	IndexFileMeta.	Realiza procesamiento de datos en archivos de entrada para tareas como detección de etiquetas, detección de rostros y detección de ubicaciones. Esta operación extrae metadatos de objetos y crea un índice, lo que permite recuperar datos de un conjunto de datos.
BatchIndexFileMeta	BatchIndexFileMeta.	Esta operación realiza una indexación por lotes de metadatos de objetos mediante el procesamiento de archivos de entrada para tareas como detección de etiquetas, detección de rostros y detección de ubicaciones. Posteriormente, los metadatos de los objetos se indexan en un conjunto de datos para admitir diversos métodos de recuperación de datos.
UpdateFileMeta	UpdateFileMeta.	Actualiza los metadatos parciales de los archivos indexados en un conjunto de datos.
BatchUpdateFileMeta	BatchUpdateFileMeta.	Actualiza algunos elementos de metadatos de archivos indexados en un conjunto de datos.
GetFileMeta	GetFileMeta.	Consulta los metadatos de un archivo cuyos metadatos están indexados en el conjunto de datos.
BatchGetFileMeta	BatchGetFileMeta.	Consulta los metadatos de múltiples objetos o archivos en el conjunto de datos especificado.
DeleteFileMeta	Eliminar metadatos de archivo.	Elimina los metadatos de un archivo de un conjunto de datos.
BatchDeleteFileMeta	BatchDeleteFileMeta.	Elimina los metadatos de varios archivos de un conjunto de datos.
Consultas y estadísticas	Consultas y estadísticas
SimpleQuery	SimpleQuery.	Consulta archivos en un conjunto de datos mediante una operación de consulta simple. La operación admite expresiones lógicas.
SemanticQuery	SemanticQuery.	Consulta metadatos en un conjunto de datos mediante lenguaje natural.
FuzzyQuery	FuzzyQuery.	Consulta los metadatos de archivos extraídos, incluido el nombre del archivo, las etiquetas, la ruta, las etiquetas personalizadas y otros campos. Si el valor de un campo de metadatos de un archivo coincide con la cadena especificada, se devuelven los metadatos del archivo.
Gestión inteligente	Gestión inteligente
Agrupación facial	Agrupación facial
CreateFigureClusteringTask	CreateFigureClusteringTask.	Crea una tarea de agrupamiento de figuras. Esta tarea utiliza un algoritmo inteligente para agrupar los rostros de diferentes personas en imágenes indexadas en un conjunto de datos.
CreateFigureClustersMergingTask	CreateFigureClustersMergingTask	Merges two or more figure clustering groups into a single figure clustering group.
GetFigureCluster	GetFigureCluster.	Obtiene información básica sobre la agrupación de rostros, incluida la hora de creación, el número de imágenes y la portada.
QueryFigureClusters	QueryFigureClusters.	Consulta grupos de rostros según las condiciones especificadas.
BatchGetFigureCluster	BatchGetFigureCluster.	Consulta los clústeres de rostros.
UpdateFigureCluster	UpdateFigureCluster.	Actualiza la información de un clúster de rostros, como el nombre del clúster y las etiquetas.
SearchImageFigureCluster	SearchImageFigureCluster.	Consulta los clústeres de rostros que contienen un rostro específico en una imagen. Cada clúster de rostros contiene información como cuadros delimitadores y similitud.
CreateFacesSearchingTask	CreateFacesSearchingTask.	Busca en un conjunto de medios las N imágenes principales más similares a una imagen especificada o a un ID de rostro. La operación devuelve los ID de rostro correspondientes y los cuadros delimitadores, ordenados por similitud en orden descendente.
Agrupación espaciotemporal	Agrupación espaciotemporal
CreateLocationDateClusteringTask	CreateLocationDateClusteringTask.	La función de agrupamiento espaciotemporal clasifica los archivos de un conjunto de datos según su hora y ubicación. Esta función opera con archivos indexados, como imágenes y videos, que contienen datos de hora y lugar de captura. Estas clasificaciones pueden representar contenido de un viaje del usuario, donde los archivos tienen marcas de tiempo y ubicaciones similares. Las clasificaciones también pueden representar contenido capturado en diferentes lugares donde el usuario vive o trabaja. El análisis de las ubicaciones y los intervalos de tiempo de estas clasificaciones permite categorizar archivos multimedia, crear resúmenes de video y generar historias de fotos y videos.
QueryLocationDateClusters	QueryLocationDateClusters.	Consulta una lista de clústeres espacio-temporales según las condiciones especificadas.
UpdateLocationDateCluster	UpdateLocationDateCluster.	Actualiza un clúster espacio-temporal.
DeleteLocationDateCluster	DeleteLocationDateCluster.	Elimina un clúster espaciotemporal.
Historias	Historias
CreateStory	CreateStory.	Crea una historia.
QueryStories	Consultar historias.	Consulta historias según las condiciones especificadas.
GetStory	GetStory.	Consulta una historia.
CreateCustomizedStory	CreateCustomizedStory	Creates a story based on the specified images and videos.
UpdateStory	UpdateStory.	Actualiza la información de una historia, como el nombre de la historia y la imagen de portada.
AddStoryFiles	AddStoryFiles.	Agrega objetos a una historia.
RemoveStoryFiles	Eliminar archivos de historia.	Elimina archivos de una historia.
DeleteStory	Eliminar una historia.	Elimina una historia.
Agrupación de imágenes	Agrupación de imágenes
CreateSimilarImageClusteringTask	CreateSimilarImageClusteringTask.	La función de agrupación de imágenes similares organiza las imágenes que usted ha indexado en un conjunto de datos en clústeres según su similitud visual. Esta función es útil para escenarios como la deduplicación de imágenes o la selección de las mejores tomas. Por ejemplo, puede utilizarla para filtrar fotos en ráfaga en un álbum.
QuerySimilarImageClusters	QuerySimilarImageClusters.	Consulta la lista de clústeres de imágenes similares.
Vinculación de datos	Vinculación de datos
CreateBinding	CreateBinding.	Crea una relación de vinculación entre un conjunto de datos y un bucket de Object Storage Service (OSS). Esto permite la sincronización automática de datos incrementales y completos, así como su indexación.
GetBinding	GetBinding.	Consulta la relación de vinculación entre un conjunto de datos específico y un bucket de Object Storage Service (OSS).
ListBindings	Consultar la lista de vinculaciones.	Consulta la lista de vinculaciones entre conjuntos de datos y buckets de Object Storage Service (OSS).
DeleteBinding	DeleteBinding.	Elimina el vínculo entre un conjunto de datos y un bucket de Object Storage Service (OSS).
AttachOSSBucket	AttachOSSBucket.	Vincula un bucket de Object Storage Service (OSS) al proyecto especificado. La vinculación permite utilizar las funciones de IMM mediante el parámetro x-oss-process.
DetachOSSBucket	DetachOSSBucket.	Desvincula un bucket de Object Storage Service (OSS) del proyecto correspondiente.
GetOSSBucketAttachment	Obtener información de vinculación de bucket de OSS.	Obtiene el nombre del proyecto vinculado a un bucket de OSS especificado en la misma región.

Procesamiento de imágenes

API	Título	Descripción
EncodeBlindWatermark	EncodeBlindWatermark.	Inserta información textual específica en una imagen como marcas de agua. Estas marcas de agua son visualmente imperceptibles y no afectan la estética de la imagen ni la integridad de los datos originales. Las marcas de agua se pueden extraer mediante la operación CreateDecodeBlindWatermarkTask.
CreateDecodeBlindWatermarkTask	CreateDecodeBlindWatermarkTask	Extracts a blind watermark.
GetDecodeBlindWatermarkResult	Obtener el resultado de la tarea de extracción de marca de agua invisible.	Obtiene el resultado de una tarea de extracción de marca de agua invisible para una imagen.
DetectImageLabels	DetectImageLabels.	Detecta información de escenas, objetos y eventos en una imagen. La información de escenas incluye paisajes naturales, vida cotidiana y desastres. La información de eventos incluye programas de talentos, eventos de oficina, presentaciones y eventos de producción. La información de objetos incluye vajilla, dispositivos electrónicos, muebles y medios de transporte. La operación DetectImageLabels admite más de 30 categorías diferentes y miles de etiquetas.
DetectImageScore	DetectImageScore.	Calcula la puntuación de calidad estética de una imagen basándose en métricas como la composición, el brillo, el contraste, el color y la resolución. La operación devuelve una puntuación en el rango de 0 a 1. Una puntuación más alta indica una mejor calidad de imagen.
DetectImageCodes	DetectImageCodes.	Detecta códigos de barras y códigos QR en una imagen.
DetectImageFaces	DetectImageFaces.	Detecta rostros en una imagen, incluida la información de límites del rostro, atributos y calidad. La información de límites incluye la distancia desde la coordenada y del vértice hasta el borde superior (Top), la distancia desde la coordenada x del vértice hasta el borde izquierdo (Left), la altura (Height) y el ancho (Width). Los atributos del rostro incluyen la edad (Age), la desviación estándar de la edad (AgeSD), el género (Gender), la emoción (Emotion), la apertura de la boca (Mouth), la barba (Beard), el uso de sombrero (Hat), el uso de mascarilla (Mask), el uso de anteojos (Glasses), la orientación de la cabeza (HeadPose), el atractivo (Attractive) y los niveles de confianza de los atributos anteriores. La información de calidad incluye la puntuación de calidad del rostro (FaceQuality) y la resolución del rostro (Sharpness).
DetectImageCropping	Detección de regiones óptimas de recorte de imágenes mediante capacidades de modelos de IA.	Detecta regiones de recorte visualmente óptimas en una imagen con una relación de aspecto especificada mediante capacidades de modelos de IA.
AddImageMosaic	Agregar mosaico a imagen.	Agrega mosaicos, desenfoques gaussianos o formas de color sólido para difuminar una o más áreas de una imagen con el fin de proteger la privacidad, y guarda la imagen de salida en la ruta especificada de Object Storage Service (OSS).
CreateImageToPDFTask	CreateImageToPDFTask.	Convierte varias imágenes en un solo archivo PDF y guarda el archivo como un objeto de OSS especificado.
CreateImageSplicingTask	CreateImageSplicingTask.	Une múltiples imágenes en una sola imagen según reglas especificadas y guarda el resultado en un objeto de OSS especificado.
CompareImageFaces	CompareImageFaces.	Compara la similitud de los rostros más grandes en dos imágenes. El rostro más grande se refiere al marco de rostro de mayor tamaño detectado en una imagen tras la detección de rostros.
DetectImageBodies	Detectar cuerpos en imágenes.	Detecta información de cuerpos humanos, como el nivel de confianza y el cuadro delimitador del cuerpo, en una imagen.
DetectImageCars	DetectImageCars.	Detecta los datos de contorno, los atributos y la información de la matrícula de los vehículos en una imagen. Los atributos del vehículo incluyen el color del vehículo (CarColor) y el tipo de vehículo (CarType). La información de la matrícula incluye el contenido reconocido (Content) y el marco de la placa (Boundary).
DetectImageTexts	DetectImageTexts.	Reconoce y extrae contenido de texto de una imagen.

Procesamiento de medios

API	Título	Descripción
CreateMediaConvertTask	Crear tarea de transcodificación de medios.	Crea una tarea de transcodificación de medios asíncrona. Esta tarea procesa archivos de audio y video para la transcodificación de medios, la concatenación de medios, la captura de fotogramas de video y la generación de GIF animados.
DetectMediaMeta	Obtener metadatos de archivos multimedia.	Obtiene los metadatos de un archivo multimedia, incluida la información del formato y de las secuencias multimedia.
CreateVideoLabelClassificationTask	CreateVideoLabelClassificationTask.	Detecta etiquetas para escenarios, objetos y eventos en contenido de video. Esta función admite más de 30 categorías y miles de etiquetas. Las etiquetas de escenario incluyen paisajes naturales, escenas cotidianas y escenas de desastres. Las etiquetas de evento incluyen programas de talentos, trabajo de oficina, presentaciones artísticas y producción. Las etiquetas de objeto incluyen vajilla, productos electrónicos, muebles y vehículos.
GetVideoLabelClassificationResult	Get video label detection task	Obtiene el resultado de una tarea de detección de etiquetas de video.
GenerateVideoPlaylist	Generar una lista de reproducción de transcodificación justo a tiempo.	Crea una lista de reproducción de transcodificación justo a tiempo que genera un archivo M3U8 a partir de un archivo de video, habilita la reproducción instantánea después de la generación de la lista y realiza la transcodificación bajo demanda según el progreso de la reproducción. En comparación con la transcodificación sin conexión, esta operación reduce significativamente el tiempo de espera de transcodificación y disminuye considerablemente los costos de transcodificación y almacenamiento.
CreateHighlightTask	Create a video highlight clipping task	Creates a video highlight task. This feature is in invitational preview.

Procesamiento de documentos

API	Título	Descripción
GenerateWebofficeToken	Obtener credenciales de weboffice.	Obtiene las credenciales de vista previa y edición para un documento.
RefreshWebofficeToken	Actualizar un token de weboffice.	Actualiza un token de acceso de Weboffice. Un token de acceso de Weboffice tiene una validez de 30 minutos. Una vez que caduca, ya no es posible acceder a Weboffice. Para continuar accediendo a Weboffice, invoque esta operación para actualizar el token de acceso de Weboffice y obtener un nuevo token que también tendrá una validez de 30 minutos.
CreateOfficeConversionTask	CreateOfficeConversionTask.	Crea una tarea de conversión de documentos que convierte archivos, como Word, PowerPoint, Excel y PDF, almacenados en Object Storage Service (OSS) a imágenes, archivos de texto o archivos PDF.
ExtractDocumentText	Extraer texto de documento.	Extrae texto de un documento.

Procesamiento de archivos

API	Título	Descripción
Compresión y descompresión	Compresión y descompresión
CreateFileCompressionTask	CreateFileCompressionTask.	API de descarga de paquetes.
CreateArchiveFileInspectionTask	CreateArchiveFileInspectionTask.	Crea una tarea para inspeccionar un archivo comprimido y obtener una lista de su contenido sin descomprimir el archivo.
CreateFileUncompressionTask	CreateFileUncompressionTask.	Una tarea de descompresión de archivos le permite descomprimir archivos específicos o un paquete comprimido completo en una ubicación especificada. Los formatos admitidos incluyen Zip, RAR y 7z.
Compresión de nubes de puntos	Compresión de nubes de puntos
CreateCompressPointCloudTask	Crear una tarea de compresión de nube de puntos.	Comprime datos de nube de puntos almacenados en Object Storage Service (OSS) para reducir la transmisión de datos por la red.

Seguridad de contenido

API	Título	Descripción
DetectTextAnomaly	Detección de anomalías en texto.	Detecta si el texto especificado contiene anomalías, como pornografía, publicidad, contenido basura excesivo, contenido políticamente sensible y abuso.
CreateImageModerationTask	CreateImageModerationTask.	Detecta contenido no conforme en imágenes, como pornografía, terrorismo, escenas no deseadas, logotipos y violaciones de texto en imagen.
CreateVideoModerationTask	CreateVideoModerationTask.	Detecta amenazas o contenido no conforme en videos. Esta operación se puede utilizar en escenarios como detección de pornografía, detección de terrorismo y contenido políticamente sensible, detección de infracciones de texto e imagen, detección de escenas no deseadas y detección de logotipos.
GetImageModerationResult	Obtener una tarea de moderación de contenido de imagen.	Obtiene una tarea de moderación de contenido de imagen.
GetVideoModerationResult	Obtener una tarea de moderación de contenido de video.	Obtiene una tarea de moderación de contenido de video.

Gestión de tareas

API	Título	Descripción
GetTask	Obtener información de la tarea.	Consulta la información de una tarea asíncrona especificada. Intelligent Media Management (IMM) admite diversas capacidades de procesamiento de datos asíncrono, cada una con su propia operación de creación de tareas, como CreateFigureClusteringTask para crear tareas de agrupación de figuras y CreateFileCompressionTask para crear tareas de compresión de archivos. Esta es una operación de propósito general que permite consultar los detalles de una tarea asíncrona mediante el ID y el tipo de tarea.
ListTasks	ListTasks	Lists tasks based on specific conditions, such as by time range and by tag.
Desencadenadores	Desencadenadores
CreateTrigger	CreateTrigger	Creates a trigger to start data processing in Intelligent Media Management (IMM). The trigger is activated by event sources, such as Object Storage Service (OSS), and uses data processing templates to process media files, such as images, videos, and documents.
SuspendTrigger	SuspendTrigger	Suspends a running trigger.
ResumeTrigger	ResumeTrigger.	Reanuda un desencadenador que se encuentra en estado Suspendido o Fallido.
UpdateTrigger	UpdateTrigger	Updates information about a trigger, such as the input data source, data processing settings, and tags.
GetTrigger	GetTrigger.	Consulta la información de un desencadenador.
ListTriggers	ListTriggers.	Consulta los activadores por etiqueta o estado.
DeleteTrigger	DeleteTrigger.	Elimina un disparador.
Procesamiento por lotes	Procesamiento por lotes
CreateBatch	CreateBatch	Creates a batch processing task that performs specified operations, such as transcoding and format conversion, on multiple existing files.
SuspendBatch	Suspender una tarea de procesamiento por lotes.	Suspende una tarea de procesamiento por lotes.
ResumeBatch	ResumeBatch.	Reanuda una tarea de procesamiento por lotes que se encuentra en estado Suspendido o Fallido.
UpdateBatch	UpdateBatch.	Actualiza la información de una tarea de procesamiento por lotes, como la configuración del origen de datos, la configuración del procesamiento de datos y las etiquetas.
ListBatches	ListBatches.	Consulta tareas de procesamiento por lotes. Puede consultar tareas de procesamiento por lotes según condiciones como etiquetas de tarea y estado. Los resultados se pueden ordenar.
GetBatch	GetBatch.	Consulta la información de una tarea de procesamiento por lotes.
DeleteBatch	DeleteBatch	Deletes a batch processing task.

Otros

API	Título	Descripción
ContextualAnswer	API de preguntas y respuestas en el Asistente de IA.	Realiza consultas y obtiene respuestas mediante la API de preguntas y respuestas de la Fase II del Asistente de IA.
ContextualRetrieval	ContextualRetrieval	Retrieves semantically similar documents. The operation is designed for multi-turn conversations and can process message input in historical conversations. The operation returns results that are highly related to the current conversation based on an in-depth understanding of contextual content. It provides consistent and efficient information retrieval in multi-turn conversations.
ListAttachedOSSBuckets	Listar relaciones de vinculación de buckets de OSS.	Lista los adjuntos vinculados.