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