Centro de documentos

Todos los productos

Centro de documentos

Intelligent Media Management:CreateImageModerationTask

Última actualización: Sep 01, 2026

Detecta contenido no conforme en imágenes, como pornografía, terrorismo, escenas no deseadas, logotipos y violaciones de texto en imagen.

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 ejecución de las tareas asíncronas.
Requisitos de la imagen:
- Las URL de imagen admiten los protocolos HTTP y HTTPS.
- Se admiten los siguientes formatos de imagen: PNG, JPG, JPEG, BMP, GIF y WEBP.
- El tamaño de la imagen no puede superar los 20 MB tanto para invocaciones síncronas como asíncronas. La altura o anchura no puede exceder los 30,000 píxeles, y el número total de píxeles no puede superar los 250 millones. Para imágenes GIF, el número total de píxeles no puede exceder los 4,194,304, y la altura o anchura no puede superar los 30,000 píxeles.
- El tiempo de espera de descarga de la imagen es de 3 segundos. Si la descarga tarda más de 3 segundos, se devuelve un error de tiempo de espera.
- Para obtener mejores resultados, la resolución de la imagen debe ser de al menos 256 × 256 píxeles. Una baja resolución puede afectar la precisión de la detección.
- El tiempo de respuesta para la detección de imágenes depende del tiempo de descarga de la imagen. Asegúrese de que el servicio de almacenamiento donde se encuentra la imagen sea estable y confiable. Utilice Alibaba Cloud Object Storage Service (OSS) o CDN.
Esta es una operación asíncrona. Después de que se inicia una tarea, su información se conserva solo durante 7 días. No puede consultar la información después de este periodo. Para ver la información de la tarea, puede llamar a la operación GetTask o ListTasks y utilizar el TaskId devuelto. Alternativamente, puede configurar el parámetro Notification para recibir la información de la tarea mediante mensajes de notificación asíncronos.

Nota

Los resultados de la detección se devuelven en un mensaje de notificación asíncrono. El campo Suggestion en el mensaje tiene uno de los siguientes valores:

pass: La imagen pasó la revisión. No se detectó contenido no conforme.
block: La imagen no pasó la revisión. Se detectó contenido no conforme. El campo Categories indica la categoría no conforme. Para obtener más información sobre las categorías, consulte Resultados de detección de Content Moderation.
review: La imagen requiere revisión manual. Una vez completada la revisión manual, se envía otro mensaje de notificación asíncrono para informarle del resultado.

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:CreateImageModerationTask

create

*Project

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

Ninguna

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.	test-project
UserData	string	No	La información personalizada. Esta información se devuelve en el mensaje de notificación asíncrono para ayudarle a asociar el mensaje con su sistema. El valor puede tener una longitud máxima de 2,048 bytes.	test-data
SourceURI	string	Sí	El URI de OSS de la imagen. El URI debe seguir el formato `oss://<Bucket>/<Object>`. `<Bucket>` es el nombre del bucket de OSS que se encuentra en la misma región que el proyecto. `<Object>` es la ruta completa del archivo, incluida la extensión del nombre del archivo.	oss://test-bucket/test-object
Tags	object	No	Las etiquetas personalizadas. Puede utilizar etiquetas para buscar y filtrar tareas asíncronas.	{ "User": "Jane" }
CredentialConfig	CredentialConfig	No	La configuración de autorización encadenada. Este parámetro es opcional. Para obtener más información, consulte Utilizar autorización encadenada para acceder a recursos de otras entidades.
Scenes	array	No	Los escenarios de detección de imágenes.
	string	No	El escenario de detección de imágenes. Valores válidos: porn: detección de pornografía. terrorism: detección de terrorismo y contenido político. live: detección de escenas no deseadas. logo: detección de logotipos. ad: detección de violaciones de texto e imagen. Nota Si no especifica un escenario de detección, se utilizan por defecto los escenarios `porn`, `terrorism` y `ad`. Valores válidos: ad : Violaciones de anuncios. terrorism : Terrorismo y contenido político. logo : Detección de logotipos. live : Escenas no deseadas. porn : Detección de pornografía.	porn
Interval	integer	No	La frecuencia de captura de fotogramas. Este parámetro se utiliza para la detección de GIF e imágenes largas. El valor predeterminado es 1.	2
MaxFrames	integer	No	El número máximo de fotogramas a capturar. Este parámetro se utiliza para la detección de GIF e imágenes largas. El valor predeterminado es 1.	10
Notification	Notification	No	La configuración de notificación. Para obtener más información sobre el formato de los mensajes de notificación asíncronos, consulte 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.	ImageModeration-179ef4f8-d583-4f0c-a293-7c0889c*****
EventId	string	El ID del evento.	2E6-1I0FGn0zFnl5AflRfhzClma*****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "1B3D5E0A-D8B8-4DA0-8127-ED32C851****",
  "TaskId": "ImageModeration-179ef4f8-d583-4f0c-a293-7c0889c*****",
  "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.