CreateVideoModerationTask - Intelligent Media Management - Centro de documentación de Alibaba Cloud

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.

Descripción de la operación

Antes de utilizar esta operación, asegúrese de comprender los métodos de facturación y los precios de Intelligent Media Management.

Importante
No se garantiza el tiempo de finalización de las tareas asíncronas.
Los resultados de la detección se devuelven en un mensaje de notificación asíncrono. El campo Suggestion en el mensaje de notificación asíncrono puede tener los siguientes valores:
- pass: El video pasó la revisión. No se detectó contenido no conforme.
- block: El video debe bloquearse. Este valor se devuelve cuando se detecta contenido no conforme. El campo Categories indica la categoría del contenido no conforme. Para obtener más información sobre las categorías, consulte Resultados de detección de Content Moderation.
- review: El video requiere revisión manual. Una vez completada la revisión manual, se envía otro mensaje de notificación asíncrono con el resultado.
Requisitos para las instantáneas de video:
- Las URL de los fotogramas de video admiten los protocolos HTTP y HTTPS.
- Formatos de fotogramas de video compatibles: PNG, JPG, JPEG, BMP, GIF y WEBP.
- El tamaño de un fotograma de video no puede superar los 10 MB.
- La resolución recomendada para los fotogramas de video es de al menos 256 × 256 píxeles. Una resolución más baja puede afectar la precisión de la detección.
- El tiempo de respuesta de la operación de detección de video depende del tiempo de descarga de los fotogramas de video. Asegúrese de que el servicio de almacenamiento para sus fotogramas de video sea estable y confiable. Se recomienda utilizar Alibaba Cloud Object Storage Service (OSS) o almacenar en caché los fotogramas con Alibaba Cloud CDN.
Esta es una operación asíncrona. Después de crear una tarea, la información de la tarea se conserva solo durante 7 días. Transcurrido este período, la información no se puede recuperar. Puede llamar a la operación GetTask o ListTasks para consultar la información de la tarea mediante el TaskId devuelto. También puede configurar el parámetro Notification para recibir información de la tarea a través de mensajes de notificación asíncronos.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

imm:CreateVideoModerationTask

create

*Project

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ProjectName	string	Sí	El nombre del proyecto. Para obtener más información sobre cómo obtener el nombre del proyecto, consulte Crear un proyecto.	immtest
UserData	string	No	Información personalizada que se devuelve en el mensaje de notificación asíncrono. Utilice esta información para asociar el mensaje de notificación con su sistema interno. La longitud máxima es de 2,048 bytes.	{"ID": "user1","Name": "test-user1","Avatar": "http://example.com?id=user1"}
SourceURI	string	Sí	El URI de OSS del video. El URI de OSS debe seguir el formato oss://${Bucket}/${Object}. `${Bucket}` es el nombre del bucket de OSS en la misma región que el proyecto. `${Object}` es la ruta completa del archivo, incluida la extensión del nombre de archivo.	oss://test-bucket/test-object
Tags	object	No	Etiquetas personalizadas utilizadas para buscar tareas.	{"test": "val1"}
CredentialConfig	CredentialConfig	No	La configuración de autorización encadenada. Este parámetro es opcional. Para obtener más información, consulte Uso de autorización encadenada para acceder a recursos de otras entidades.
Scenes	array	No	Los escenarios de detección de video.
	string	No	El escenario de detección de video. Valores válidos: porn: Detección de pornografía. terrorism: Detección de terrorismo y contenido políticamente sensible. live: Detección de escenas no deseadas. logo: Detección de logotipos. ad: Detección de infracciones de texto e imagen. Nota Si no especifica un escenario de detección, se utilizan de forma predeterminada los escenarios `porn`, `terrorism` y `ad`. Valores válidos: ad : Detección de infracciones de texto e imagen. terrorism : Detección de terrorismo y contenido políticamente sensible. logo : Detección de logotipos. live : Detección de escenas no deseadas. porn : Detección de pornografía.	porn
Interval	integer	No	El intervalo para las instantáneas de video, en segundos. El valor puede ser un número entero de 1 a 600. El valor predeterminado es 1.	1
MaxFrames	integer	No	El número máximo de fotogramas que se pueden capturar para esta tarea de detección. El valor puede ser un número entero de 5 a 3,600. El valor predeterminado es 200.	200
Notification	Notification	No	La configuración de notificación. Para conocer el formato de los mensajes de notificación asíncronos, consulte la sección de índice de metadatos en Formato de mensaje de notificación asíncrono.

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	La estructura de la respuesta.
RequestId	string	El ID de la solicitud.	1B3D5E0A-D8B8-4DA0-8127-ED32C851****
TaskId	string	El ID de la tarea.	VideoModeration-9442a216-4691-4a48-846d-76daccaf*****
EventId	string	El ID del evento.	2E6-1I0FGn0zFnl5AflRfhzClma*****

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.