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

# Extracción de metadatos de IA

> Cómo Truthlocks utiliza la IA para categorizar y describir automáticamente su contenido protegido.

Cuando protege contenido en Truthlocks, la IA analiza automáticamente su archivo para generar metadatos, incluido un título, descripción, categoría y etiquetas sugeridos. Esto enriquece sus registros de protección y los hace más fáciles de buscar, compartir y verificar.

## Cómo funciona

Cuando carga un archivo en la página de Protección, Truthlocks envía el nombre del archivo, el tipo, el tamaño y una vista previa (para archivos de texto) o datos EXIF (para imágenes) a un modelo de IA. El archivo en sí permanece en su navegador; solo se envían metadatos para su análisis.

**1. Archivo seleccionado**

Usted selecciona o arrastra un archivo a la página de Protección.

**2. Metadatos extraídos**

Truthlocks lee las propiedades básicas del archivo (nombre, tipo MIME, tamaño) y, cuando
si corresponde, extrae datos EXIF de imágenes o una vista previa de texto de código y
archivos de documentos.

**3. Análisis de IA**

Los metadatos extraídos se envían al modelo de IA, que devuelve un resultado estructurado
respuesta con categoría, tipo de contenido, descripción, título sugerido, etiquetas,
y más.

**4. Revisar y editar**

Los campos generados por IA aparecen como sugerencias. Puede editar cualquier campo antes de
confirmando su protección.

> [!NOTE]
>
> La extracción de metadatos de IA es automática y se ejecuta en segundo plano tan pronto como usted
> seleccione un archivo. Usted siempre tiene la última palabra: edite o anule cualquier
> sugerencia antes de proteger.

## Categorías soportadas

La IA clasifica su contenido en una de las siguientes categorías según el tipo de archivo y el análisis de contenido:

| Categoría | Tipos de archivo |
| - | - |
| **Fotografía** | Formatos JPEG, PNG, WebP, TIFF, RAW |
| **Arte digital** | PSD, AI, SVG, Procreate, HEIC |
| **Código fuente** | JS, TS, Python, Go, Rust, Java, C/C++ y más de 30 lenguajes |
| **Documento** | PDF, DOCX, TXT, Markdown, LaTeX |
| **Música** | MP3, WAV, FLAC, AAC, MIDI |
| **Video** | MP4, MOV, AVI, WebM, MKV |
| **Diseño** | Archivos Figma, Sketch, XD |
| **Datos** | CSV, JSON, XML, SQL, Parquet |

## Campos de metadatos generados

La IA produce los siguientes campos para cada archivo:

| Campo | Descripción |
| - | - |
| `category` | Categoría de contenido (ver tabla anterior) |
| `content_type` | Tipo de contenido específico dentro de la categoría (por ejemplo, "fotografía de paisajes") |
| `suggested_title` | Un título legible por humanos basado en el nombre y el contenido del archivo |
| `description` | Una breve descripción de lo que contiene el archivo |
| `tags` | Palabras clave relevantes para búsqueda y descubrimiento |
| `language` | Lenguaje de programación (para archivos de código fuente) |
| `framework` | Framework o biblioteca detectada (para archivos de código fuente) |
| `license_hint` | Licencia detectada o sugerida (si es identificable) |
| `subject_matter` | El tema principal o asunto del contenido |

## Resúmenes de prueba

Cada certificado de protección incluye un resumen generado por IA que describe qué se protegió y cuándo. El resumen aparece en la página de prueba pública debajo de los detalles del certificado y está diseñado para compartir y previsualizaciones de enlaces.

Los resúmenes de prueba se generan automáticamente cuando alguien ve una página de prueba. No es necesario configurarlos ni activarlos.

| Detalle | Descripción |
| - | - |
| **Contenido** | Una explicación de 2 a 3 oraciones de la protección — qué se protegió, su categoría y la fecha de protección |
| **Respaldo** | Si la IA no está disponible, se genera un resumen basado en plantillas para que la página de prueba siempre muestre una descripción legible |
| **Indicador** | Los resúmenes generados por IA muestran un pequeño icono de brillo y una etiqueta de "resumen generado por IA" |
| **Almacenamiento en caché** | Los resúmenes se almacenan en caché por página de prueba y se revalidan cada cinco minutos. Los visitantes posteriores ven la versión en caché, lo que reduce la latencia y el uso de IA |

### Cómo funciona el almacenamiento en caché

Cuando el primer visitante carga una página de prueba, la plataforma genera un resumen de IA y lo almacena en caché. Durante los siguientes cinco minutos, todos los visitantes ven el resultado almacenado en caché. Después de cinco minutos, la siguiente solicitud activa una nueva generación de IA y actualiza la caché.

Si el modelo de IA no está disponible en el momento de la generación, el resultado almacenado en caché es una alternativa basada en plantillas. La caché sigue aplicándose: la alternativa se sirve durante un máximo de cinco minutos antes de que la plataforma vuelva a intentar la generación de IA.

> [!NOTE]
>
> Los resúmenes de pruebas se almacenan en caché y se revalidan cada cinco minutos. El primer visitante a una página de prueba activa la generación del resumen, y los visitantes posteriores ven la versión en caché hasta que se actualiza. No necesita gestionar el almacenamiento en caché usted mismo.

### Resúmenes de respaldo

Cuando el modelo de IA no está disponible, la página de prueba muestra un resumen de plantilla determinista en su lugar. Los resúmenes de plantilla incluyen:

* La categoría de contenido y la fecha de protección.
* Una nota de que la prueba criptográfica está anclada al registro de transparencia de Truthlocks.
* Un indicador de procedencia: si el contenido fue cargado por una persona (en lugar de a través de una API), el resumen incluye una nota que confirma la presentación humana.

Los resúmenes de plantillas no muestran el icono de brillo, por lo que siempre puede saber si un resumen fue generado por IA.

> [!TIP]
>
> Los resúmenes de pruebas utilizan únicamente los metadatos que proporcionó al proteger su contenido: título, descripción, categoría y fecha. Nunca se accede a su archivo original.

## Detección de similitudes

Antes de acuñar una protección, Truthlocks verifica si ya existe un hash de archivo similar. Esto evita protecciones duplicadas y le alerta si el contenido fue registrado previamente, ya sea por usted o por otro usuario.

Si se encuentra una coincidencia, verá una advertencia con detalles sobre la protección existente antes de continuar. Cada coincidencia incluye:

* **Puntuación de similitud** — qué tan cerca coincide el contenido con una protección existente.
* **Propietario** — el nombre de usuario de la persona que protegió el original.
* **Fecha** — cuando se creó la protección original.
* **Bandera de coincidencia exacta** — si el hash del contenido es idéntico a un registro existente.

## Uso de metadatos de IA con la API

Al llamar al punto final de acuñación, puede incluir campos extraídos por IA para enriquecer su registro de protección:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/consumer/mint \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "content_hash": "e3b0c44298fc1c149afbf4c8...",
    "title": "Sunset at Big Sur",
    "description": "Landscape photograph taken at Pfeiffer Beach",
    "file_name": "sunset-big-sur.jpg",
    "file_size": 4521984,
    "content_type": "landscape photography",
    "category": "photography",
    "tags": ["landscape", "sunset", "california", "beach"],
    "visibility": "public"
  }'
```

> [!TIP]
>
> Al usar la API, puede omitir la extracción de IA y proporcionar sus propios metadatos
> directamente. La función de extracción de IA está disponible en la interfaz web y
> se ejecuta automáticamente.

## Privacidad

La extracción de metadatos de IA sigue el mismo modelo de privacidad que el resto de Truthlocks:

* **Su archivo nunca sale de su navegador.** Solo el nombre del archivo, el tipo MIME, el tamaño y una pequeña vista previa o datos EXIF se envían para su análisis.
* **El servicio de IA no almacena contenido de archivos**. Los metadatos se generan en tiempo real y se devuelven a su navegador.
* **Usted controla lo que se envía.** Revise y edite todos los campos generados por IA antes de confirmar su protección.

## Próximos pasos

> [card] [Protección de contenido](https://docs.truthlocks.com/guides/content-protection.md)
>
> Guía completa para proteger su contenido con atestaciones criptográficas.

> [card] [Portal del consumidor](https://docs.truthlocks.com/guides/consumer-portal.md)
>
> Gestiona protecciones, credenciales y configuraciones desde tu panel de control.

> [card] [Insignias incrustables](https://docs.truthlocks.com/guides/badges.md)
>
> Añada insignias de verificación a su sitio web o README.

> [card] [Portafolio público](https://docs.truthlocks.com/guides/portfolio.md)
>
> Muestre el trabajo verificado en una página de perfil público.


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