> ## 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.

# Extração de metadados por IA

> Como a Truthlocks usa IA para categorizar e descrever automaticamente seu conteúdo protegido.

Quando você protege conteúdo no Truthlocks, a IA analisa automaticamente seu arquivo para gerar metadados — incluindo um título sugerido, descrição, categoria e tags. Isso enriquece seus registros de proteção e os torna mais fáceis de pesquisar, compartilhar e verificar.

## Como funciona

Ao carregar um arquivo na página Proteger, o Truthlocks envia o nome do arquivo, tipo, tamanho e uma pré-visualização (para arquivos de texto) ou dados EXIF (para imagens) para um modelo de IA. O arquivo em si permanece em seu navegador — apenas metadados são enviados para análise.

**1. Arquivo selecionado**

Você seleciona ou arrasta um arquivo para a página Proteger.

**2. Metadados extraídos**

Truthlocks lê as propriedades básicas do arquivo (nome, tipo MIME, tamanho) e, onde
aplicável, extrai dados EXIF de imagens ou uma pré-visualização de texto de código e
arquivos de documentos.

**3. Análise de IA**

Os metadados extraídos são enviados ao modelo de IA, que retorna um
resposta com categoria, tipo de conteúdo, descrição, título sugerido, tags,
e mais.

**4. Revisar e editar**

Campos gerados por IA aparecem como sugestões. Você pode editar qualquer campo antes de
confirmando sua proteção.

> [!NOTE]
>
> A extração de metadados por IA é automática e é executada em segundo plano assim que você
> selecione um arquivo. Você sempre tem a palavra final — edite ou substitua qualquer
> sugestão antes de proteger.

## Categorias suportadas

A IA classifica seu conteúdo em uma das seguintes categorias com base no tipo de arquivo e análise de conteúdo:

| Categoria | Tipos de arquivo |
| - | - |
| **Fotografia** | Formatos JPEG, PNG, WebP, TIFF, RAW |
| **Arte digital** | PSD, AI, SVG, Procreate, HEIC |
| **Código-fonte** | JS, TS, Python, Go, Rust, Java, C/C++ e mais de 30 outras linguagens |
| **Documento** | PDF, DOCX, TXT, Markdown, LaTeX |
| **Música** | MP3, WAV, FLAC, AAC, MIDI |
| **Vídeo** | MP4, MOV, AVI, WebM, MKV |
| **Design** | Arquivos Figma, Sketch, XD |
| **Dados** | CSV, JSON, XML, SQL, Parquet |

## Campos de metadados gerados

A IA produz os seguintes campos para cada arquivo:

| Campo | Descrição |
| - | - |
| `category` | Categoria de conteúdo (ver tabela acima) |
| `content_type` | Tipo de conteúdo específico dentro da categoria (por exemplo, "fotografia de paisagem") |
| `suggested_title` | Um título legível por humanos baseado no nome e conteúdo do arquivo |
| `description` | Uma breve descrição do que o arquivo contém |
| `tags` | Palavras-chave relevantes para pesquisa e descoberta |
| `language` | Linguagem de programação (para arquivos de código-fonte) |
| `framework` | Framework ou biblioteca detetada (para ficheiros de código fonte) |
| `license_hint` | Licença detetada ou sugerida (se identificável) |
| `subject_matter` | O assunto ou tópico principal do conteúdo |

## Resumos de prova

Todo certificado de proteção inclui um resumo gerado por IA que descreve o que foi protegido e quando. O resumo aparece na página de prova pública abaixo dos detalhes do certificado e é projetado para compartilhamento e pré-visualizações de links.

Os resumos de prova são gerados automaticamente quando alguém visualiza uma página de prova. Você não precisa configurá-los ou acioná-los.

| Detalhe | Descrição |
| - | - |
| **Conteúdo** | Uma explicação de 2 a 3 frases da proteção — o que foi protegido, sua categoria e a data da proteção |
| **Fallback** | Se a IA estiver indisponível, um resumo baseado em modelo é gerado em vez disso, para que a página de prova sempre exiba uma descrição legível |
| **Indicador** | Resumos gerados por IA mostram um pequeno ícone de brilho e um rótulo "Resumo gerado por IA" |
| **Cache** | Os resumos são armazenados em cache por página de prova e revalidados a cada cinco minutos. Visitantes subsequentes veem a versão em cache, reduzindo a latência e o uso de IA |

### Como funciona o cache

Quando o primeiro visitante carrega uma página de prova, a plataforma gera um resumo de IA e o armazena em cache. Pelos próximos cinco minutos, todos os visitantes veem o resultado em cache. Após cinco minutos, a próxima requisição aciona uma nova geração de IA e atualiza o cache.

Se o modelo de IA estiver indisponível no momento da geração, o resultado em cache será um fallback baseado em modelo. O cache ainda se aplica — o fallback é servido por até cinco minutos antes que a plataforma tente novamente a geração de IA.

> [!NOTE]
>
> Os resumos de prova são armazenados em cache e revalidados a cada cinco minutos. O primeiro visitante de uma página de prova aciona a geração do resumo, e os visitantes subsequentes veem a versão em cache até que ela seja atualizada. Você não precisa gerenciar o cache por conta própria.

### Resumos de recurso

Quando o modelo de IA não está disponível, a página de prova exibe um resumo de modelo determinístico. Os resumos de modelo incluem:

* A categoria de conteúdo e a data de proteção.
* Uma nota de que a prova criptográfica está ancorada no log de transparência da Truthlocks.
* Um indicador de proveniência — se o conteúdo foi carregado por uma pessoa (em vez de via API), o resumo inclui uma nota confirmando o envio humano.

Os resumos de modelos não mostram o ícone de brilho, então você sempre pode saber se um resumo foi gerado por IA.

> [!TIP]
>
> Os resumos de prova usam apenas os metadados que você forneceu ao proteger seu conteúdo — título, descrição, categoria e data. Seu arquivo original nunca é acessado.

## Detecção de similaridade

Antes de cunhar uma proteção, o Truthlocks verifica se um hash de arquivo semelhante já existe. Isso evita proteções duplicadas e o alerta se o conteúdo foi registrado anteriormente — seja por você ou por outro usuário.

Se uma correspondência for encontrada, você verá um aviso com detalhes sobre a proteção existente antes de prosseguir. Cada correspondência inclui:

* **Pontuação de similaridade** — quão próximo o conteúdo corresponde a uma proteção existente.
* **Proprietário** — o nome de usuário da pessoa que protegeu o original.
* **Data** — quando a proteção original foi criada.
* **Sinalizador de correspondência exata** — se o hash do conteúdo é idêntico a um registro existente.

## Usando metadados de IA com a API

Ao chamar o endpoint de emissão, você pode incluir campos extraídos por IA para enriquecer seu registro de proteção:

```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]
>
> Ao usar a API, você pode pular a extração de IA e fornecer seus próprios metadados
> diretamente. O recurso de extração de IA está disponível na interface web e
> executa automaticamente.

## Privacidade

A extração de metadados por IA segue o mesmo modelo de privacidade do restante da Truthlocks:

* **Seu arquivo nunca sai do seu navegador.** Apenas o nome do arquivo, tipo MIME, tamanho e uma pequena prévia ou dados EXIF são enviados para análise.
* **Nenhum conteúdo de arquivo é armazenado** pelo serviço de IA. Metadados são gerados em tempo real e retornados ao seu navegador.
* **Você controla o que é enviado.** Revise e edite todos os campos gerados por IA antes de confirmar sua proteção.

## Próximos passos

> [card] [Proteção de conteúdo](https://docs.truthlocks.com/guides/content-protection.md)
>
> Guia completo para proteger seu conteúdo com atestações criptográficas.

> [card] [Portal do consumidor](https://docs.truthlocks.com/guides/consumer-portal.md)
>
> Gerencie proteções, credenciais e configurações a partir do seu painel.

> [card] [Badges incorporáveis](https://docs.truthlocks.com/guides/badges.md)
>
> Adicione selos de verificação ao seu site ou README.

> [card] [Portfólio público](https://docs.truthlocks.com/guides/portfolio.md)
>
> Mostre o trabalho verificado em uma página de perfil público.


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