---
title: AIDA API
emoji: 🔍
colorFrom: indigo
colorTo: gray
sdk: docker
app_port: 7860
pinned: false
license: other
license_name: aida-p0-pesos-sob-revisao
license_link: https://huggingface.co/AIDAON/aida-p0/blob/main/LICENSES.md
---

# AIDA — API de análise de imagens

Backend do AIDA: recebe uma imagem e devolve indícios de que ela seja uma
fotografia real ou uma imagem gerada/manipulada por IA — ou **inconclusivo**,
quando não há base para decidir.

O front-end é um site separado que consome esta API.

## Rotas

| Rota | Descrição |
|---|---|
| `GET /` | status e módulos carregados |
| `GET /contrato` | contrato completo de `POST /analisar` |
| `GET /saude` | diagnóstico: o que está treinado, política em vigor |
| `GET /teste` | página técnica para testar sem o front-end |
| `POST /analisar` | analisa uma imagem (campo `imagem`, multipart) |
| `GET /evidencia/<id>/<mapa>` | PNG de um mapa de explicabilidade |

## Estados possíveis

`resultado` tem **quatro** valores: `REAL`, `REAL_EDITADA`, `IA/MANIPULADA` e
`INCONCLUSIVO`.

`REAL_EDITADA` é uma fotografia que a análise de conteúdo considera real e cujo
arquivo registra edição em um editor de imagem (Lightroom, Photoshop, Photopea,
GIMP, Snapseed...). A informação vem dos metadados (EXIF `Software`, XMP
`CreatorTool`, histórico do XMP e ajustes do Camera Raw), não do modelo: uma foto
editada que perdeu os metadados sai como `REAL`. Os campos `editada` e
`editores` dizem o que foi encontrado. O valor `IA/MANIPULADA` foi mantido por
compatibilidade e significa gerada por IA, inteira ou em parte.

Quando `fora_de_dominio` é `true`, a imagem não é fotográfica (texto, desenho,
cor sólida) e **as probabilidades não têm significado** — mostre o `titulo`.

O campo `ressalva` é obrigatório na interface: o resultado é indício, não prova.

## Variáveis de ambiente

| Variável | Padrão | Efeito |
|---|---|---|
| `ALLOWED_ORIGINS` | `*` | domínios autorizados, separados por vírgula |
| `AIDA_MODO_RAPIDO` | vazio | `1` usa só o ramo CLIP: ~0,2 s por imagem em vez de ~2 s |

## Limitações

O resultado é probabilístico, não identifica autoria e não substitui a
verificação da fonte da imagem.

Medido em **882 imagens de fontes nunca vistas** (504 reais, 378 geradas):
acurácia 85,3%, especificidade 88,9%, recall de IA 80,4%, com abstenção em
~14% dos casos. No conjunto de teste fechado (546 imagens): acurácia 89,4%.

A ferramenta foi treinada para comparar **fotografias** com imagens geradas por
IA. Capturas de texto, gráficos, desenhos e logotipos estão fora do escopo — o
detector de fora-de-domínio recusa esses casos em vez de responder.

Limitação conhecida: a imagem recebida é normalizada para 1024 px antes da
análise, para ficar no mesmo domínio dos dados de treino. Isso significa que
sinais de nível de sensor (padrão de Bayer, ruído PRNU) não são utilizados.

## Licença

Este Space contém os **pesos do P0**, necessários para a inferência. A situação
de licença dos pesos é `LICENSE_UNKNOWN_REVIEW_REQUIRED`: duas questões seguem
`PENDENTE_DE_DECISAO` — (Q1) direitos sobre as fotografias de pessoas usadas no
treino e (Q2) termos de uso dos serviços geradores das imagens sintéticas. A
presença dos pesos aqui **não** resolve nenhuma das duas.

Código, metodologia, métricas e limitações, com a auditoria completa de licença:
https://huggingface.co/AIDAON/aida-p0 — ver `LICENSES.md`.