Saltar al contenido principal
Clasifica una imagen desde una URL

Autorizaciones

X-Api-Key
string
header
requerido

Tu API key.

Encabezados

Accept
enum<string>

Tipo de contenido de la respuesta. Valores admitidos: application/json, text/plain.

Opciones disponibles:
application/json,
text/plain

Cuerpo

multipart/form-data
file_url
string
requerido

La URL de la imagen que se va a clasificar.

ref_id
string

ID de referencia opcional que se asocia a la solicitud de clasificación.

with_morphing
boolean

Establécelo en true si también quieres analizar las caras de las personas de la imagen con morphing.

with_tampering
boolean

Establécelo en true si también quieres analizar signos de manipulación realizados sin la ayuda de una IA generativa

with_heatmap
boolean

Establécelo en true si también quieres obtener una heatmap de los contenidos generados por IA.

with_smart_analysis
boolean

Establécelo en true para activar la Smart Full Analysis: un algoritmo de scoring propietario selecciona las áreas más informativas de la imagen, que se clasifican como recortes separados con el modelo más avanzado de la familia Revelio y luego se combinan en un veredicto global. Al ser una versión avanzada e inteligente de ambos, sustituye al análisis completo estándar y al análisis con heatmap: no se puede combinar con with_heatmap, y enviar ambas opciones en true devuelve un error 422. Para usarla debe estar habilitada en tu plan de precios; si no, el parámetro se ignora. Consulta Smart Full Analysis para más detalles.

webhook_url
string

Si se indica, el resultado de la clasificación también se envía automáticamente a la URL introducida. Si no, el resultado se obtiene mediante polling del endpoint correspondiente. Ten en cuenta que para usar una URL de callback del webhook debes solicitar una habilitación específica; si no, el parámetro se ignora. Además, el sistema puede guardar en caché los resultados de los análisis de envíos repetidos, es decir, envíos del mismo archivo con las mismas opciones: en este caso no se llama al webhook y los resultados solo están accesibles mediante polling del endpoint correspondiente.

with_xai
boolean

Establécelo en true para activar el scope XAI – eXplainable AI: además del veredicto, los modelos Revelio devuelven información sobre las áreas de la imagen en las que se centraron durante la clasificación (attention map y attention graph). Para usarlo debe estar habilitado en tu plan de precios; si no, el parámetro se ignora. Consulta XAI – eXplainable AI para más detalles. Aviso sobre la transferencia de datos: al activar esta funcionalidad, los datos de tus imágenes se transfieren a nuestra infraestructura cloud en la UE para la inferencia de los modelos.

with_llm_xai
boolean

Establécelo en true, junto con with_xai, para obtener también las explicaciones impulsadas por IA: una descripción en lenguaje natural de las regiones que recibieron más atención, devuelta en el campo description de las explanations de los resultados por modelo cuando los resultados diferidos están listos. Se ignora si with_xai no está activado. Si XAI está incluido en tu plan de precios pero las explicaciones impulsadas por IA no, una solicitud con with_llm_xai=true se rechaza con un error 403. Los créditos de las explicaciones que no se pueden generar se reembolsan. Las explicaciones impulsadas por IA se generan con modelos no desarrollados por identifAI.

llm_xai_language
enum<string>

Idioma de las explicaciones impulsadas por IA (sin distinguir entre mayúsculas y minúsculas). Si se omite, se usa el idioma predeterminado de tu plan de precios. Solo se aplica junto con with_llm_xai; un valor no admitido se rechaza con un error 400.

Opciones disponibles:
english,
italian,
spanish,
german
deferred_webhook_url
string

Si se indica, la URL se notifica una sola vez cuando los resultados diferidos del envío están completos (p. ej., las explicaciones textuales de los mapas XAI y de la heatmap), después de los resultados principales enviados a webhook_url. La notificación lleva el evento submission.deferred.completed: consulta Resultados diferidos para ver el payload. Se aplican la misma habilitación, las mismas restricciones de dominio y la misma autenticación que en webhook_url. La entrega es at least once: deduplica por identifier, y ten en cuenta que una notificación expired puede ir seguida de una segunda con el resultado real, que la sustituye. Si se omite o está vacía, no se envía ninguna notificación de resultados diferidos.

no_cache
boolean

Establécelo en true para obligar al sistema a volver a procesar la imagen aunque ya se haya enviado con las mismas opciones. Esto puede suponer costes adicionales.

prevent_c2pa_forces
boolean

Si es true, la firma C2PA no fuerza el origen a artificial. Si es false o no está definido, la firma C2PA fuerza el origen a artificial (comportamiento actual).

with_nsfw
boolean

Establécelo en true si también quieres activar la detección de contenidos NSFW (Not Safe For Work).

Respuesta

El identificador de la clasificación. El formato depende del header Accept.

identifier
string
Ejemplo:

"8d64370a87b820cc1cf620338f5c898bab37439c9a405f32d9eaffc50c4f27b0"