> ## Documentation Index
> Fetch the complete documentation index at: https://docs.identifai.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Sigue los cambios en el ecosistema de la API v1 de identifAI. La versión tiene la forma *MAJOR.MINOR.PATCH*:
- MAJOR es fijo en 1 para la API v1.
- La publicación de nuevos endpoints o de cambios que afectan a los veredictos o a los scores de las clasificaciones incrementa MINOR.
- Cualquier otro cambio incrementa PATCH.

## Versión 1.3.2

Más reciente

2026-11-09

#### Funcionalidades

Se ha introducido el scope de análisis **XAI – eXplainable AI**: además del veredicto, los modelos Revelio devuelven información sobre las áreas del contenido en las que se centraron durante la clasificación, convertida en un **Attention Map**, un **Attention Graph** y una **explicación impulsada por IA** en lenguaje natural. XAI está disponible para imágenes y vídeos (donde se aplica a cada frame analizado); debe estar habilitado en tu plan de precios para poder usarlo. Consulta [XAI – eXplainable AI](https://docs.identifai.net/es/classification/classify-image.md#xai-explainable-ai). **Aviso sobre la transferencia de datos:** al activar esta funcionalidad, tus datos de imagen se transfieren a nuestra infraestructura cloud en la UE para la inferencia de los modelos. Las explicaciones impulsadas por IA se generan con modelos no desarrollados por identifAI.

* Se han añadido las opciones `with_xai`, `with_llm_xai` y `llm_xai_language` en la [API para la clasificación de imágenes](https://docs.identifai.net/es/api-reference/classification/submit-an-image-for-classification.md), la [API para la clasificación de imágenes desde URL](https://docs.identifai.net/es/api-reference/classification/submit-image-from-url.md), la [API para la clasificación de vídeos](https://docs.identifai.net/es/api-reference/classification/submit-a-video-for-classification.md) y la [API para la clasificación de vídeos desde URL](https://docs.identifai.net/es/api-reference/classification/submit-video-from-url.md):
  * `with_xai` activa el scope XAI; si XAI no está incluido en tu plan de precios, el parámetro se ignora;
  * `with_llm_xai`, junto con `with_xai`, activa también las explicaciones impulsadas por IA; si tu plan incluye XAI pero no las explicaciones impulsadas por IA, la solicitud se rechaza con un error `403`;
  * `llm_xai_language` establece el idioma de las explicaciones impulsadas por IA (`english`, `italian`, `spanish` o `german`, sin distinguir mayúsculas y minúsculas); un valor no admitido se rechaza con un error `400`. Si se omite, se usa el idioma predeterminado de tu plan de precios.
* Se ha añadido el campo `explanations` a los resultados por modelo del [resultado de la clasificación de imágenes](https://docs.identifai.net/es/api-reference/classification/get-classification-result.md) y de cada frame del [resultado de la clasificación de vídeos](https://docs.identifai.net/es/api-reference/classification/get-classification-result-video.md): enumera todos los mapas XAI producidos por el modelo, con su `type` (`attention_map`, `attention_graph` o `heatmap`), el `method` XAI y la `description` en lenguaje natural. Los mapas se enumeran también cuando no se solicitaron las explicaciones impulsadas por IA: `description` es `null` cuando la explicación no se solicitó, aún no está disponible o no se pudo generar. Los créditos de las explicaciones impulsadas por IA que no se pueden generar se reembolsan.
* Se ha añadido la [API para descargar un mapa XAI](https://docs.identifai.net/es/api-reference/classification/get-classification-xai.md): devuelve el Attention Map o el Attention Graph de una imagen o de un frame de vídeo, dados el `model`, el `method` XAI y el `type` de mapa. Cuando XAI se combina con el Smart Full Analysis, la heatmap se sigue descargando con el [endpoint de descarga de la heatmap](https://docs.identifai.net/es/api-reference/classification/get-classification-heatmap.md).

Se han introducido los **resultados diferidos**: resultados producidos después de los principales, sin retrasarlos, como las explicaciones impulsadas por IA de los mapas XAI y de la heatmap. Consulta [Resultados diferidos](https://docs.identifai.net/es/api-reference/deferred-results.md).

* Se ha añadido la opción `deferred_webhook_url` en las API de clasificación de imágenes, vídeos y audio de voz (también desde URL): la URL recibe una única notificación, con el evento `submission.deferred.completed`, cuando los resultados diferidos están completos. Misma habilitación, restricciones de dominio y autenticación que `webhook_url`.
* Se han añadido `deferred_status`, `deferred_progress` y `deferred_errors` a los resultados de clasificación (y a cada frame de vídeo) de los envíos con resultados diferidos.
* Los webhooks configurados en el dashboard también pueden notificar los resultados diferidos.

Los resultados principales, el payload de su webhook y el `status` no cambian.

## Versión 1.3.1

2026-11-02

#### Funcionalidades

* Se ha añadido la opción `with_smart_analysis` en la [API para la clasificación de imágenes](https://docs.identifai.net/es/api-reference/classification/submit-an-image-for-classification.md) y en la [API para la clasificación de imágenes desde URL](https://docs.identifai.net/es/api-reference/classification/submit-image-from-url.md): el flag activa el nuevo scope **Smart Full Analysis**, pero debe estar habilitado en tu plan de precios para poder usarlo; de lo contrario, el parámetro se ignora.
  Cuando está activado, un algoritmo de puntuación propietario selecciona las áreas de la imagen con mayor contenido informativo; cada recorte seleccionado es clasificado por el modelo más avanzado de la familia **Revelio** y los resultados individuales se combinan en un veredicto global.
  Al ser una versión avanzada e inteligente de ambos, Smart Full Analysis **sustituye al análisis completo estándar y al análisis de la heatmap** cuando está activado: por este motivo no se puede combinar con `with_heatmap`, y una solicitud con ambas opciones en `true` devuelve un error `422`.
  Consulta [Smart Full Analysis](https://docs.identifai.net/es/classification/classify-image.md#smart-full-analysis) para más detalles.
* Se ha añadido la misma opción `with_smart_analysis` en la [API para la clasificación de vídeos](https://docs.identifai.net/es/api-reference/classification/submit-a-video-for-classification.md) y en la [API para la clasificación de vídeos desde URL](https://docs.identifai.net/es/api-reference/classification/submit-video-from-url.md): cuando está activada, el Smart Full Analysis se aplica a cada frame analizado. Consulta [Smart Full Analysis en vídeo](https://docs.identifai.net/es/classification/classify-video.md#smart-full-analysis).

## Versión 1.3.0

2026-10-19

#### Funcionalidades

Se ha introducido el análisis de **momentos específicos**: en lugar de dejar que el sistema elija qué partes del medio analizar, puedes indicar los momentos exactos de interés de un vídeo y/o de su pista de audio, o de un audio de voz. Los momentos se pasan como una lista de timecodes `HH:MM:SS.mmm` separados por comas, medidos desde el inicio del archivo (p. ej., `00:00:05.000,00:01:12.500`).

* **Frames del vídeo**: se ha añadido la opción `frames_timestamps` en la [API de clasificación de vídeos](https://docs.identifai.net/es/api-reference/classification/submit-a-video-for-classification.md) y en la [API de clasificación de vídeos desde URL](https://docs.identifai.net/es/api-reference/classification/submit-video-from-url.md). Se extrae y analiza un frame por cada timecode indicado; la opción tiene prioridad sobre las estrategias de extracción a intervalos regulares, de keyframes y de caras (`frames`, `key_frames`, `key_frames_method` y `ensure_face_per_frame` se ignoran). Consulta [Clasifica un vídeo](https://docs.identifai.net/es/classification/classify-video.md#momentos-específicos).
* **Pista de audio del vídeo**: se ha añadido la opción `audio_timestamps` en las mismas API de vídeo, que se usa junto con `with_audio`. La pista de audio se analiza en breves segmentos centrados en los timecodes indicados, en lugar de a lo largo de toda su duración. Puede combinarse con `frames_timestamps` o usarse por sí sola.
* **Voz**: se ha añadido la opción `audio_timestamps` en la [API de clasificación de audios de voz](https://docs.identifai.net/es/api-reference/classification/submit-a-speech-for-classification.md) y en la [API de clasificación de audios de voz desde URL](https://docs.identifai.net/es/api-reference/classification/submit-speech-from-url.md), con el mismo comportamiento. Consulta [Clasifica un audio de voz](https://docs.identifai.net/es/classification/classify-speech.md#analiza-momentos-específicos).
* **Créditos y límites**: se cobra un frame / segmento de audio por cada timecode distinto; los timecodes lo bastante cercanos como para caer en el mismo segmento de audio se analizan juntos y los segmentos que no se generan se reembolsan. Se aceptan hasta 30 timecodes si tu plan de precios te permite elegir el número de frames / segmentos de audio; si no, hasta los valores predeterminados (10 frames, 5 segmentos de audio). Los timecodes con formato incorrecto o en número excesivo se rechazan con un error `400`.
* **Disponibilidad**: los momentos específicos son una funcionalidad del plan de precios, activada por separado para los frames del vídeo y para el audio; si tu plan no los incluye, `frames_timestamps` y `audio_timestamps` se ignoran.

#### Cambios

* Se ha documentado `ensure_face_per_frame` como estrategia de extracción de frames con **caras** (consulta [Clasifica un vídeo](https://docs.identifai.net/es/classification/classify-video.md#caras)): es una funcionalidad del plan de precios (se ignora si tu plan no la incluye), es una alternativa a los keyframes (`key_frames` y `key_frames_method` se ignoran cuando está activada) y se ignora cuando se indica `frames_timestamps`. Los frames que no se analizan porque no se han encontrado suficientes caras se reembolsan.

## Versión 1.2.0

2026-10-12

#### Funcionalidades

* Se ha añadido la [API de validación de medios](https://docs.identifai.net/es/api-reference/classification/validate-media.md): comprueba si un archivo de imagen, vídeo o audio puede analizarse con las opciones indicadas (tipo y tamaño del archivo, integridad, resolución mínima exigida por los modelos seleccionados) sin enviarlo a clasificación y sin consumir créditos.

## Versión 1.1.3

2026-04-09

#### Funcionalidades

* Se ha añadido un campo `details` en el payload de respuesta del envío de imágenes/vídeos, con más información sobre las detecciones individuales extraídas y analizadas del medio (las caras encontradas en la imagen/el frame cuando la opción `with_morphing` está activada).

## Versión 1.1.2

2026-03-12

#### Funcionalidades

* Se ha añadido un campo `details` en el payload de respuesta del envío de audios, con más información sobre los clips individuales extraídos del audio. Este campo está disponible con un plan de precios adecuado.
* Se ha añadido la opción `ensure_face_per_frame` en la [API de clasificación de vídeos](https://docs.identifai.net/es/api-reference/classification/submit-a-video-for-classification.md) y en la [API de clasificación de vídeos desde URL](https://docs.identifai.net/es/api-reference/classification/submit-video-from-url.md): el flag garantiza que los frames del vídeo usados para la clasificación contengan una cara, lo que mejora la precisión del análisis de los vídeos en los que aparecen caras cuando se usa junto con `with_morphing`.
* Se ha añadido la opción `with_audio` en la [API de clasificación de vídeos](https://docs.identifai.net/es/api-reference/classification/submit-a-video-for-classification.md) y en la [API de clasificación de vídeos desde URL](https://docs.identifai.net/es/api-reference/classification/submit-video-from-url.md): el flag activa el análisis de la pista de audio del vídeo, pero para usarlo debe estar habilitado en tu plan de precios. Cuando está activado, el sistema analiza la pista de audio del vídeo para detectar deepfakes, lo que ofrece un análisis más completo del contenido del vídeo.

## Versión 1.1.1

2026-01-30

#### Funcionalidades

* Cuando durante el envío se indica un `webhook_url` y el envío de la notificación falla (p. ej., por problemas de red o una URL no válida),
  el sistema ahora reintenta enviar la notificación del webhook hasta **3 veces**, con un intervalo de **10 s** entre intentos.
  Esta mejora aumenta la fiabilidad de las notificaciones de los webhooks para los clientes que dependen de ellas para recibir actualizaciones en tiempo real.

* Se ha corregido el valor de `api_version` en el payload de respuesta de las [API de polling de resultados](https://docs.identifai.net/es/api-reference/classification/get-classification-result.md),
  que ahora refleja correctamente la versión actual de la API cuando el análisis está en estado `new`.

## Versión 1.1.0

2026-01-29

#### Funcionalidades

* Se han añadido los siguientes campos a los payloads de respuesta de las [API de polling de resultados](https://docs.identifai.net/es/api-reference/classification/get-classification-result.md):

  * **Status**: indica el estado del análisis (en curso, completado o fallido)
  * **Errors**: en caso de análisis fallido, indica el motivo del fallo
  * **API Version**: indica la versión de la API en el momento del análisis, para poder comparar análisis generados por distintas versiones del backend

* **Ajuste de los umbrales** internos artificial/humano del modelo **Revelio Onboarding II**: los umbrales internos
  usados para clasificar las imágenes como artificiales o humanas se han ajustado para mejorar la precisión de la detección según los datos de evaluación más recientes.

## Versión 1.0.0

2025-01-01

### Primera versión

Te damos la bienvenida a la primera versión de la API de identifAI. Esta versión incorpora a tus aplicaciones potentes funcionalidades de detección de contenidos generados por IA.

#### Funcionalidades

* **Clasificación de imágenes**: detecta imágenes generadas por IA con nuestro ensemble de varios modelos (Revelio-IV, etc.).
* **Análisis de vídeo y audio**: endpoints especializados para detectar deepfakes en vídeos y voces.
* **Procesamiento asíncrono**: flujo de trabajo compatible con webhooks, con envío y polling de resultados.
* **API Partner**: endpoints para la gestión de usuarios y créditos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.