Primeros pasos
Regístrate en app.itsreal.media, sube una imagen desde el detector o agrupa varias en un caso para obtener una puntuación de riesgo agregada. Cada informe combina señales de redes neuronales, procedencia criptográfica (C2PA) y análisis forense de metadatos en un único Synthetic Media Score.
Cómo leer el informe
| Paso | Cómo leer el informe |
|---|---|
| 1. Synthetic Media Score | La puntuación global: 0,00 = auténtica, 1,00 = sintética. La barra de degradado ofrece una lectura visual inmediata. |
| 2. Panel de resumen | Vista rápida: veredicto, resultados de Frame:Origin y Frame:Edit, estado C2PA y resumen de metadatos. |
| 3. Paneles de detalle | Despliega cualquier sección bajo el resumen para ver el desglose completo de señales, las salidas brutas del modelo y los volcados de metadatos. |
Subir una imagen
Sube cualquier imagen desde la página del detector en el panel.
Requisitos de la imagen
- Formatos
- JPEG · PNG · WebP · AVIF
- Tamaño máximo
- 10 MB
- Dimensión mínima
- 256 px en el lado más corto
Las imágenes por debajo de la dimensión mínima se rechazan. El análisis ejecuta todos los módulos de detección y normalmente devuelve los resultados en unos segundos.
Synthetic Media Score
La puntuación representa la probabilidad global de que la imagen sea sintética, combinando las predicciones del modelo, la procedencia C2PA y el análisis de metadatos. La barra de degradado va de verde → naranja → rojo.
Anulación por C2PA y metadatos
Si hay un manifiesto C2PA criptográficamente válido, la puntuación se sobrescribe por completo: fuertemente sintético si se declara contenido generado por IA, fuertemente auténtico si se verifica como real. Si se detectan metadatos generados por IA sin un C2PA válido, la puntuación se desplaza hacia sintético. Todas las señales del modelo y los detalles de los metadatos siguen mostrándose en el informe.
En la respuesta de la API (/api/v1/analyze/) el mismo valor se devuelve como synthetic_media_score, un número entre 0.0 y 1.0. Sin un C2PA válido, equivale a la probabilidad sintética en el peor de los casos entre todos los veredictos del modelo presentes en la respuesta. Umbrales sugeridos: < 0.5 tiende a auténtica, ≥ 0.5 tiende a sintética, ≥ 0.9 alta confianza.
Datos de imagen
Propiedades técnicas extraídas del archivo de imagen: formato, dimensiones en píxeles, megapíxeles, relación de aspecto y nivel de compresión.
| Propiedad | Descripción |
|---|---|
| Formato | Formato del archivo de imagen, como JPEG, PNG, WebP o AVIF. |
| Dimensiones | Ancho y alto en píxeles. |
| Megapíxeles | Número total de píxeles expresado en megapíxeles. |
| Compresión | Nivel de compresión estimado en bits por píxel cuando se conoce el tamaño del archivo. |
Frame:Origin 1.2
Determina si una imagen fue generada en su totalidad por un sistema de IA. Ejecuta cinco señales de detección independientes, cada una analizando un aspecto diferente de la imagen.
| Señal | Qué analiza |
|---|---|
| Análisis de superficies | Patrones de ruido a nivel de píxel en superficies planas. Los generadores de IA dejan firmas características que difieren del ruido real del sensor de la cámara. |
| Análisis de bordes | Transiciones y artefactos en los bordes. Los bordes generados por IA muestran regularidades sutiles que no aparecen en capturas ópticas. |
| Frecuencia | Componentes de frecuencia mediante transformadas wavelet. Los generadores de IA producen huellas características en el dominio de la frecuencia. |
| Entropía RGB | Distribución de la entropía en los canales de color. Las fotografías reales presentan patrones de entropía naturales que a la IA le cuesta replicar. |
| Modelo generalizado | Detector de amplio espectro entrenado con datos brutos de píxeles sin preprocesamiento, diseñado para detectar técnicas de generación novedosas. |
Un modelo de ensamblado combina las cinco señales en una única puntuación de confianza.
Frame:Edit 0.8
Detecta si una fotografía real ha sido modificada parcialmente con herramientas de IA, como inpainting, intercambio de rostros, eliminación de objetos o sustitución de fondo.
| Señal | Qué analiza |
|---|---|
| Entropía RGB | Inconsistencias de entropía entre regiones modificadas y no modificadas en los canales de color. |
| Superficies | Discontinuidades de textura donde las regiones editadas por IA se encuentran con el contenido original. |
| Modelo generalizado | Detector amplio de patrones de manipulación parcial, sin filtrado específico de dominio. |
| Frecuencia | Análisis wavelet ajustado para artefactos de frecuencia localizados dejados por las herramientas de edición. |
| Mapas NLE | Mapas de Noise Level Estimation — señalan discontinuidades locales de ruido introducidas por inpainting o intercambios de rostros. |
El veredicto de edición muestra Auténtica o Imagen modificada. Este veredicto lo produce un modelo de ensamblado dedicado que agrega las cinco señales de edición anteriores.
Procedencia C2PA
C2PA (Coalition for Content Provenance and Authenticity) es un estándar criptográfico que incrusta certificados firmados en los archivos de imagen, creando una cadena de procedencia resistente a manipulaciones.
| Estado | Significado |
|---|---|
| Origen verificado | Capturada por un dispositivo certificado y sin modificar desde la firma. |
| Edición transparente | Editada, pero cada edición está documentada en el manifiesto firmado. |
| Alterada | Existe un manifiesto C2PA pero la firma está rota, lo que implica manipulación. |
| No verificada | Existe un manifiesto C2PA, pero no pudo establecerse la autenticidad por limitaciones de confianza, cumplimiento o del validador. |
| Sin C2PA | No se encontró ningún manifiesto de procedencia, por lo que deben usarse otros métodos. |
Los detalles C2PA incluyen el firmante, el generador del caso, las acciones realizadas y, cuando están disponibles, los ingredientes de origen.
Análisis de metadatos
Examina campos de metadatos incrustados como IPTC, XMP y EXIF en busca de rastros que revelen cómo se creó la imagen.
| Resultado | Qué significa |
|---|---|
| Indicios de medios sintéticos | Los metadatos contienen identificadores de herramientas de IA, como campos IPTC 2025.1 o rastros heredados en XMP tipo CreatorTool o DigitalSourceType. |
| Metadatos estándar | Los datos EXIF, XMP o de la estructura JPEG pueden mostrarse como referencia; no se usan como señal de autenticidad. |
| Ninguno | No se encontraron indicios relevantes. Es posible que los metadatos se eliminaran al exportar o subir la imagen. |
Metadatos sin procesar
Volcados completos y sin procesar de los metadatos del archivo de imagen. Especialmente útiles para investigación forense y depuración.
| Fuente | Contenido |
|---|---|
| EXIF | Metadatos de cámara y captura: marca, modelo, objetivo, exposición, GPS, marcas de tiempo. |
| XMP | Herramientas de edición, fechas de creación y propiedades relacionadas con IA. |
| IPTC | Metadatos editoriales como fotógrafo, pie de foto, palabras clave, derechos de autor y ubicación. |
| Texto PNG | Fragmentos de texto usados a menudo por herramientas de IA para registrar parámetros de generación. |
| Perfil ICC | Información sobre el espacio de color y el perfil de visualización. |
| Información JPEG | Versión JFIF, submuestreo y estimaciones de calidad. |
Puntuación de riesgo del caso
Un caso agrupa una o varias imágenes con una descripción y genera una única puntuación de riesgo que representa la probabilidad de que alguna de las imágenes enviadas contenga medios sintéticos. La puntuación va de 0,0 (auténtica) a 99,9 (sintética).
| Veredicto | Rango de puntuación | Significado |
|---|---|---|
| RIESGO BAJO | 0 – 32,9 | Todas las imágenes parecen auténticas. No se detectaron señales sintéticas relevantes. |
| RIESGO MEDIO | 33,0 – 65,9 | Señales mixtas o inciertas. Se recomienda una revisión manual. |
| RIESGO ALTO | 66,0 – 99,9 | Indicadores sólidos de contenido generado o modificado por IA. |
Cada imagen del caso se puntúa de forma independiente mediante un sistema de prioridad de tres capas; a continuación, la puntuación del caso se determina por agregación del peor caso (gana la puntuación por imagen más alta).
Agregación del peor caso
Una sola imagen de alto riesgo basta para elevar todo el caso. Si un caso contiene cuatro fotos auténticas y una imagen generada por IA, la puntuación del caso reflejará la imagen sintética.
| Capa | Fuente | Cómo funciona |
|---|---|---|
| A. Procedencia C2PA | Manifiesto criptográfico | Máxima prioridad. Si un manifiesto C2PA verificado indica contenido generado por IA (mediante el tipo de fuente digital IPTC o un generador de IA conocido en el firmante o el agente de software), la puntuación se fija en 99,0. Si confirma una procedencia real de cámara, la puntuación se fija en 1,0. Un C2PA alterado, no verificado o ausente pasa a la siguiente capa. |
| B. Predicciones del modelo | Ensamblado de Frame:Origin / Frame:Edit | La predicción final del ensamblado (o el clasificador binario Frame:Origin como respaldo) proporciona una etiqueta y una confianza. La confianza se convierte en una probabilidad sintética: real al 95 % de confianza equivale a 5,0, mientras que ai-generated al 90 % de confianza equivale a 90,0. |
| C. Ajuste por metadatos | Indicios IPTC, XMP, EXIF | Se aplica sobre la puntuación del modelo. Cuando se detectan metadatos de IA (etiquetas XMP de IA, firmas de herramienta EXIF), la puntuación se desplaza con fuerza hacia sintético (peso 0,80). Si no hay metadatos de IA, la puntuación del modelo permanece sin cambios. Los metadatos no relacionados con IA (EXIF, estructura JPEG) se muestran por transparencia pero no ajustan la puntuación. |
Desglose de la puntuación
Cada informe de caso incluye un panel detallado Desglose de la puntuación que muestra la contribución de cada capa (C2PA, predicciones del modelo, metadatos) para cada imagen. Despliega el desglose para entender exactamente por qué se asignó una puntuación.
Los casos pueden crearse desde la página Nuevo caso del panel. Pueden adjuntarse hasta cinco imágenes por caso. Todas las imágenes se analizan en paralelo y la puntuación de riesgo se finaliza una vez procesadas todas.
Visión general de la API
La API de it'sREAL.media proporciona acceso programático al análisis de imágenes. Autentícate con una API key mediante el encabezado Authorization. La documentación interactiva completa también está disponible en Swagger UI.
https://api.itsreal.media
Authorization: Token YOUR_API_KEY
Genera API keys desde la página API key. Cada cuenta puede tener hasta 10 claves con nombre, listadas con el nombre que tú elijas; puedes eliminar cualquiera de forma individual. La clave completa solo se muestra una vez al crearla — guárdala de forma segura. La palabra literal Token es obligatoria — Bearer se rechaza con 401. Las API keys autorizan POST /api/v1/analyze/ y POST /api/v1/analyze/metadata/; únicamente carga multipart.
Endpoint Analyze
El endpoint principal para la detección de imágenes por IA. Sube una imagen y obtén resultados de análisis al instante.
Archivos aceptados
- Formatos
- JPEG · PNG · WebP · AVIF
- Tamaño máximo
- 10 MB
- Dimensión mínima
- 256 px en el lado más corto
Las imágenes por debajo de la dimensión mínima se rechazan con un error 422 Unprocessable Entity.
Sube y analiza una imagen para determinar si es real o generada por IA. Admite los formatos JPEG, PNG, WebP y AVIF hasta 10 MB.
| Parámetro | Tipo | Descripción |
|---|---|---|
| file obligatorio | binary | Archivo de imagen a analizar (JPEG, PNG, WebP, AVIF, máx. 10 MB) |
| Campo | Significado |
|---|---|
| synthetic_media_score | Valor principal — úsalo como señal primaria de decisión. Un número entre 0.0 (auténtica) y 1.0 (sintética). Consulta Synthetic Media Score para ver cómo se calcula y los umbrales sugeridos. |
| verdict_label | Veredicto global de 3 clases — uno de "real", "ai-generated" o "partially-modified". Combínalo con synthetic_media_score para mostrar una etiqueta + puntuación en tu UI. |
| fully_gen_label / fully_gen_confidence | Pipeline Frame:Origin. Responde a "¿esta imagen fue generada íntegramente por IA?" La etiqueta es "real" o "ai-generated" con un valor de confianza en [0.0, 1.0]. |
| partially_mod_label / partially_mod_confidence | Pipeline Frame:Edit. Responde a "¿se editó una foto real con herramientas de IA?" La etiqueta es "real" o "partially-modified". Es independiente del veredicto de origen — una imagen puede tener origen auténtico y aun así estar parcialmente modificada. |
| metadata_analysis | Procedencia C2PA, coincidencias en EXIF/XMP/IPTC y motores de IA detectados. Ya está incorporado en synthetic_media_score a través de la prioridad C2PA; se expone aquí por transparencia y para auditoría. |
| individual_predictions | Probabilidades de "real" por modelo, provenientes de cada modelo base del ensemble. Útil para depuración o para construir heurísticas personalizadas sobre las señales en bruto. |
| image_features | Ancho, alto, relación de aspecto y número total de píxeles de la imagen analizada. |
| Estado | Descripción |
|---|---|
| 400 | Tipo de archivo no válido, archivo demasiado grande, archivo ausente o por debajo del mínimo de 256 px |
| 401 | Token no válido o ausente |
| 402 | Cuota mensual superada |
| 429 | Límite de tasa superado — respeta el encabezado Retry-After |
| 503 | Analizador no disponible — reintenta con backoff exponencial |
| 504 | El análisis superó el tiempo límite — se puede reintentar (idempotente) |
Las respuestas 5xx usan { "status": "failed", "error": "<reason>" } donde reason es uno de analysis-timeout, analyzer-error o unexpected-error.
Ejemplo rápido
Endpoint Analyze Metadata
Devuelve únicamente los metadatos incrustados — C2PA, EXIF, XMP, IPTC, ICC y PNG-text. Sin inferencia de modelos, sin consumo de cuota.
Archivos aceptados
- Formatos
- JPEG · PNG · WebP · AVIF
- Tamaño máximo
- 10 MB
- Dimensión mínima
- ninguna
- Cuota
- sin medición
Lee únicamente los metadatos incrustados de una imagen — procedencia criptográfica (C2PA) más EXIF, XMP, IPTC, ICC y PNG-text. La imagen nunca llega al detector de red neuronal y no se persiste. La autenticación y las restricciones de archivo coinciden con /api/v1/analyze/: Authorization: Token <api_key>, JPEG/PNG/WebP/AVIF, tope de 10 MB.
| Parámetro | Tipo | Descripción |
|---|---|---|
| file obligatorio | binary | Archivo de imagen a inspeccionar (JPEG, PNG, WebP, AVIF, máx. 10 MB) |
Las claves se omiten cuando su parser no encontró nada — la respuesta nunca contiene subcampos con valor null. La forma de metadata_analysis es idéntica a la del mismo campo en /api/v1/analyze/, por lo que los consumidores pueden compartir el código de parseo.
| Campo | Significado |
|---|---|
| status | "analyzed" si tuvo éxito, "failed" cuando el parser no pudo abrir el archivo o lanzó una excepción interna. El estado HTTP se mantiene en 200 en ambos casos, así que ramifica según status, no según errores HTTP. |
| metadata_analysis | Bloque plano de metadatos. ai_detected es el booleano principal; c2pa aporta el estado de procedencia y las acciones; exif, xmp_parsed, iptc, icc_profile, png_text y jpeg_info exponen sus respectivos bloques en bruto. null cuando status == "failed". |
| error | Presente solo cuando status == "failed". Actualmente el único valor es metadata-extraction-failed. |
| Estado | Descripción |
|---|---|
| 400 | Archivo ausente o formato no admitido |
| 401 | Token no válido o ausente |
| 413 | El archivo supera 10 MB |
Un fallo del parser no emite un 5xx — devuelve HTTP 200 con { "status": "failed", "metadata_analysis": null, "error": "metadata-extraction-failed" } de modo que el mismo manejador de respuesta cubre tanto el éxito como los problemas del parser.
Ejemplo rápido
Límites y cuotas
Restricciones operativas que se aplican a toda solicitud autenticada.
- Cuota mensual
- 1000 imágenes por cuenta (por defecto)
- Tasa de ráfaga
- 10 solicitudes por segundo
- Tasa sostenida
- 60 solicitudes por minuto
Las respuestas de cuota incluyen los encabezados X-QuotaLimit-Limit y X-QuotaLimit-Remaining; si se supera la cuota se devuelve 402 Payment Required. Si se superan los límites de tasa se devuelve 429 Too Many Requests con un encabezado Retry-After. Todas las API keys de una cuenta comparten los mismos cupos — gestiona el uso desde la página Cuenta.
Solución de problemas y FAQ
Problemas comunes y soluciones para sacar el máximo partido de itsreal.media.
Revisa los formatos admitidos y los límites de tamaño en la sección Subir una imagen de arriba. Las causas más habituales son superar el límite de tamaño del archivo, formatos no admitidos o imágenes por debajo de la dimensión mínima. Prueba a recargar la página y subirla de nuevo.
Si sigues experimentando problemas que no aparecen aquí, escribe a nuestro equipo de soporte a support@itsreal.media o usa el formulario de contacto de nuestro sitio. Solemos responder en menos de 24 horas.