Uma imagem
JPG, PNG, WEBP, BMP, HEIC ou AVIF, com até 15 MB, junto com a chave de acesso da sua aplicação.
Soluções AIDA
Versão inicial · v1
AIDA API
Leve a análise do AIDA para dentro do seu sistema. Seu programa envia uma imagem por HTTP e recebe, em JSON, o mesmo resultado que a plataforma mostra: o veredito em três estados, a probabilidade, os scores de cada método, as evidências visuais e a ressalva.
Verificando o serviço…
Consultando o endpoint de saúde da API.
Uma porta para outros programas usarem o AIDA.
Na plataforma, uma pessoa envia a imagem pela tela. Com a API, quem envia é outro sistema — o site de uma redação, uma ferramenta de moderação, um projeto de pesquisa — sem ninguém precisar abrir o AIDA. A análise é exatamente a mesma: não existe um detector diferente para a API.
Um resultado completo
Veredito, probabilidade, confiança, notas de cada método, qualidade da imagem, limitações e links para os mapas de evidência.
Quem verifica imagens em volume
Redações e agências de checagem, plataformas de denúncia e moderação, pesquisa acadêmica e ensino de letramento digital.
Três passos até o primeiro resultado.
Peça uma chave
A chave identifica a sua aplicação e define a cota de uso. Ela é emitida pela equipe do AIDA.
Envie a imagem
Um POST em formulário (multipart) com o arquivo no campo image.
Leia o resultado
Trate os três estados e mostre a probabilidade de exibição junto com a ressalva.
Requisição
curl
curl -X POST https://<host-da-api>/v1/analyze/image \
-H "Authorization: Bearer <sua-chave>" \
-F "image=@foto.jpg" \
-F "evidence=true"
# evidence=true pede também os mapas visuais
Resposta
200 · application/json
{
"api_version": "v1",
"analysis_id": "0842f5ce-…",
"result": "REAL",
"inconclusive": false,
"out_of_domain": false,
"confidence": "alta",
"ai_probability": 0.086,
"module_scores": { "clip": 0.268, "forense": 0.016, "rigid": 0.455 },
"limitations": [],
"evidence": { "maps": { … } },
"disclaimer": "Este resultado é probabilístico…",
"model_version": "AIDA-2.0"
}Endpoints da versão 1.
A documentação completa, gerada do próprio contrato do serviço, fica em
GET /v1/docs; o contrato em formato de máquina, em GET /v1/contract.
| Método | Rota | Para que serve | Chave |
|---|---|---|---|
| POST | /v1/analyze/image | Analisa uma imagem e devolve o resultado. | sim |
| GET | /v1/analysis/{analysis_id} | Reabre uma análise recente pelo id. | sim |
| GET | /v1/evidence/{analysis_id}/{mapa} | Baixa um mapa de evidência visual (PNG). | sim |
| GET | /v1/health | Saúde do serviço: Core alcançável, fila e latência. | não |
| GET | /v1/contract | Contrato versionado em JSON. | não |
| GET | /v1/docs | Documentação navegável. | não |
O que toda integração precisa respeitar.
Trate os quatro resultados
result vale REAL, REAL_EDITADA,
IA/MANIPULADA ou INCONCLUSIVO. Um if/else
binário rotularia como IA justamente o que o sistema declarou indeterminado, ou uma foto
real que só passou por um editor. REAL_EDITADA vem dos metadados do
arquivo (os editores ficam em editors): uma foto reenviada por aplicativo de
mensagem perde esse registro e sai como REAL.
Mostre ai_probability
É a escala de exibição, com corte em 50%. A probabilidade calibrada, em
calibration, usa outro ponto de corte e confunde quem lê.
Exiba o disclaimer
O resultado é um indício técnico, não uma prova de autoria ou de manipulação. A ressalva deve acompanhar o resultado em qualquer interface.
Cota e erros
60 análises por hora por chave (padrão). 401 chave inválida,
413 arquivo grande demais, 429 cota esgotada — respeite o
cabeçalho Retry-After.
Uma camada fina sobre o AIDA Core.
A API não tem lógica de detecção própria. Ela recebe a requisição, confere a chave, valida o arquivo, aplica a cota, entrega a imagem ao AIDA Core e devolve a resposta no contrato versionado. Assim, a decisão é sempre a mesma que a plataforma mostra.
Borda HTTP
Autenticação por chave (Bearer), limite de uso por janela, validação de formato e tamanho.
Orquestração
Fila para requisições simultâneas, cache por conteúdo e registro de cada chamada.
AIDA Core
O mesmo pipeline do AIDA Image: CLIP, módulo forense, RIGID, fusão calibrada e proveniência.
Contrato /v1
Campos estáveis em inglês; mudanças que quebram compatibilidade só em uma nova versão.
Acesso
Pedir uma chave
Quer integrar o AIDA?
Conte à equipe qual é o seu projeto e o volume esperado de imagens. A chave é emitida com a cota adequada ao uso.
O resultado do AIDA é um indício técnico, nunca uma prova sobre a origem de um conteúdo.
Voltar para as soluções