Saltar al contenido principal
Clasifica un vídeo 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 del vídeo que se va a clasificar.

ref_id
string

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

frames
enum<integer>

Elige clasificar como máximo 5, 10 o 30 frames.

Opciones disponibles:
5,
10,
30
key_frames
boolean

Si se establece en true, extrae los keyframes y los usa para la clasificación en lugar de imágenes a una distancia de tiempo fija. Los keyframes extraídos pueden ser menos que los frames solicitados. Se ignora cuando se indica ensure_face_per_frame o frames_timestamps.

key_frames_method
enum<string>

Algoritmo de identificación de keyframes. Los valores posibles son iframes (predeterminado), flow y color.

  • iframes : extrae los iframes del vídeo;
  • color : devuelve el frame medio, según el color, de cada secuencia de plano. Las secuencias de plano son grupos de frames que empiezan con un iframe;
  • flow : devuelve el frame más estático respecto al frame anterior de cada secuencia de plano.
Opciones disponibles:
iframes,
flow,
color
with_tampering
boolean

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

with_morphing
boolean

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

with_audio
boolean

[BETA] Establécelo en true si también quieres analizar la pista de audio del vídeo. Para usar esta opción debe estar habilitada en tu plan de precios.

with_smart_analysis
boolean

Establécelo en true para activar la Smart Full Analysis en cada frame analizado: un algoritmo de scoring propietario selecciona las áreas más informativas del frame, 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 de los frames. 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 cada frame analizado en las que se centraron durante la clasificación (attention map y attention graph). XAI se aplica a cada frame analizado. 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. Las explicaciones se generan para cada frame analizado. 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).

ensure_face_per_frame
boolean

[Funcionalidad del plan] Establécelo en true para elegir la estrategia de extracción de frames con caras: a partir del muestreo a intervalos regulares, el sistema busca en el vídeo frames que contengan al menos una cara, hasta el número de frames que hay que analizar (frames). Úsalo junto con la opción with_morphing para detectar posibles face swaps o morphing en el vídeo. Es una alternativa a las demás estrategias: cuando está activado, key_frames y key_frames_method se ignoran, mientras que él mismo se ignora cuando se indica frames_timestamps. La búsqueda tiene un límite de tiempo, así que en los vídeos en los que las caras son escasas o no aparecen es posible que se analicen menos frames: los frames no analizados se reembolsan al terminar el análisis. Esta opción puede aumentar el tiempo de procesamiento y, según tu plan de precios, el coste de cada frame. Para usar esta opción debe estar habilitada en tu plan de precios; si no, el parámetro se ignora.

frames_timestamps
string

[Funcionalidad del plan] Momentos específicos del vídeo que se van a analizar. Lista de timecodes separados por comas en formato HH:MM:SS.mmm, medidos desde el inicio del archivo (p. ej., 00:00:05.000,00:01:12.500). Cuando se indica, se extrae exactamente un frame en cada momento indicado y las demás estrategias de extracción de frames se desactivan: frames, key_frames, key_frames_method y ensure_face_per_frame se ignoran. Los momentos duplicados se cuentan una sola vez. Puedes indicar hasta 30 momentos si tu plan de precios te permite elegir el número de frames; si no, hasta el número de frames predeterminado (10). Se cobra un frame por cada momento distinto. Los momentos posteriores al final del vídeo se omiten: si ninguno cae dentro del vídeo, la clasificación termina con un error. Para usar esta opción debe estar habilitada en tu plan de precios; si no, el parámetro se ignora.

Ejemplo:

"00:00:05.000,00:01:12.500"

audio_timestamps
string

[Funcionalidad del plan] Momentos específicos de la pista de audio del vídeo que se van a analizar. Lista de timecodes separados por comas en formato HH:MM:SS.mmm, medidos desde el inicio del archivo (p. ej., 00:00:05.000,00:01:12.500). Solo se usa junto con with_audio. Cuando se indica, en lugar de dividir el audio en segmentos a lo largo de toda su duración, el sistema analiza un breve segmento de audio centrado en cada momento indicado; los momentos lo bastante cercanos como para caer en el mismo segmento se analizan juntos en un único segmento. Los momentos duplicados se cuentan una sola vez. Puedes indicar hasta 30 momentos si tu plan de precios te permite elegir el número de segmentos de audio; si no, hasta 5. Se cobra un segmento de audio por cada momento distinto: los segmentos que no se generan (momentos agrupados, momentos posteriores al final del audio) se reembolsan al terminar el análisis. Si ningún momento cae dentro del audio, la clasificación termina con un error. Para usar esta opción debe estar habilitada en tu plan de precios; si no, el parámetro se ignora.

Ejemplo:

"00:00:05.000,00:01:12.500"

Respuesta

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

identifier
string
Ejemplo:

"8d64370a87b820cc1cf620338f5c898bab37439c9a405f32d9eaffc50c4f27b0"