API de Detecção de Falsificação de Imagens
Acesso para desenvolvedores
Detecte adulteração em documentos e imagens com uma API REST pronta para produção.
Exemplos de Solicitação e Resposta
Use estes exemplos para construir e depurar sua integração
Exemplo de Solicitação HTTP
POST https://{your-api-domain}/forgery_detection
Cabeçalhos:
Authorization: Bearer {YOUR_API_TOKEN}
Content-Type: application/json; charset=UTF-8
Body:
{
"image": "<BASE64_IMAGE_WITHOUT_PREFIX>",
"return_heatmap": "false",
"detect_proportion": "false",
"restrict_probability": "0.8"
}Exemplos de Resposta
Resposta bem-sucedida
Quando a solicitação é válida e a imagem é processada com sucesso, a API retorna detection_result para indicar se a imagem foi adulterada (fake) ou é autêntica (real), além de confiança, heatmap e coordenadas quando solicitados.
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
{
"code": 0,
"data": {
"detection_result": "fake",
"tampered_proportion": 0.000587,
"heatmap": "<BASE64_HEATMAP_IMAGE>",
"tampered_location": [
{
"left": 100,
"top": 200,
"width": 150,
"height": 100,
"probability": 0.95
}
]
},
"message": "Success"
}Resposta de erro comercial
Quando o serviço upstream relata um erro comercial, a API retorna erro = "API_ERROR" e um código diferente de zero. Você pode mapear este código usando a tabela de códigos de erro abaixo.
HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=UTF-8
{
"error": "API_ERROR",
"code": 1004,
"message": "Image size error. Please ensure the image is less than 5MB and the longest side is less than 4000px."
}Introdução API
A tecnologia de Inteligência Artificial especializada em detecção de falsificação de imagens foi facilitada mais do que nunca usando a API ImgAuth.com. Com apenas algumas linhas de código, você pode trazer esta tecnologia para sua aplicação.
Escolha créditos de API
Selecione o pacote de créditos de API adequado ao seu volume de integração
Obtenha acesso à API
Após a compra, veja sua chave API e endpoint no painel da conta
Usar Exemplos de Código
Use os seguintes exemplos de código para começar rapidamente
Entrar em produção
Monitore o uso, ajuste os parâmetros e vá para produção
Autenticação
Autentique solicitações com o endpoint da API da sua conta e um token Bearer. Após comprar créditos de API, você pode ver seu endpoint e token no painel da conta. Mantenha seu token em segredo e nunca o envie para repositórios públicos.
Endpoint API
Substitua {your-api-domain} pelo endpoint de API mostrado no painel da sua conta.
Cabeçalhos
Exemplos de Código
Comece rapidamente com nossos exemplos de código
#!/usr/bin/env bash
set -euo pipefail
API_DOMAIN="https://{your-api-domain}"
API_PATH="/forgery_detection"
API_TOKEN="{YOUR_API_TOKEN}"
IMAGE_FILE="${1:-testpaper.jpg}"
BASE64_IMAGE=$(base64 -i "$IMAGE_FILE" | tr -d '
')
read -r -d '' JSON_BODY <<EOF || true
{
"image": "$BASE64_IMAGE",
"return_heatmap": "false",
"detect_proportion": "false",
"restrict_probability": "0.8"
}
EOF
curl -X POST "${API_DOMAIN}${API_PATH}" \
-H "Authorization: Bearer ${API_TOKEN}" \
-H "Content-Type: application/json; charset=UTF-8" \
-d "$JSON_BODY" \
-o response.json \
-s -w "\nHTTP status: %{http_code}\n"Parâmetros de Solicitação
Configure suas solicitações API com estes parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
| image | string | Dados de imagem codificados em Base64 e depois codificados para URL. Máximo de 10 MB. Lado menor com pelo menos 512 px e lado maior com no máximo 8192 px. Suporta jpg/jpeg/png/bmp. Envie image ou url. |
| url | string | URL completa da imagem, com até 1024 bytes. A imagem codificada deve ficar abaixo de 10 MB. Lado menor com pelo menos 512 px e lado maior com no máximo 8192 px. Suporta jpg/jpeg/png/bmp. Envie image ou url e desative a proteção anti-hotlink. |
| return_heatmap | string | Define se um heatmap de falsificação deve ser retornado. Padrão: false. true retorna um heatmap em Base64; false não retorna. |
| detect_proportion | string | Define se a pontuação de confiança da adulteração deve ser retornada. Padrão: false. true retorna a pontuação; false não retorna. |
| restrict_probability | string | Limite para retornar coordenadas de falsificação. Intervalo: 0.1 a 1 com 1 casa decimal. Padrão: 0.8. tampered_location só é retornado quando probability atinge ou supera esse limite. |
Parâmetros de resposta
Referência dos campos de resposta da API
| Parâmetro | Tipo | Descrição |
|---|---|---|
| detection_result | string | Resultado da adulteração: "fake" significa adulteração detectada e "real" significa nenhuma adulteração detectada. |
| tampered_proportion | float | Pontuação de confiança da adulteração, retornada quando detect_proportion = true. |
| heatmap | string | Heatmap Base64 das regiões adulteradas, retornado quando return_heatmap = true. |
| tampered_location | array | Array com coordenadas de regiões suspeitas, retornado quando probability é maior ou igual a restrict_probability. Cada item inclui left, top, width, height e probability. |
| left | uint32 | Coordenada horizontal do canto superior esquerdo da região suspeita. |
| top | uint32 | Coordenada vertical do canto superior esquerdo da região suspeita. |
| width | uint32 | Largura da região suspeita. |
| height | uint32 | Altura da região suspeita. |
| probability | float | Pontuação de confiança para esta região suspeita. |
Códigos de Erro
Referência para códigos de resposta API
| Código de Erro | Mensagem de Erro |
|---|---|
| 0 | success |
| 1000 | body error |
| 1001 | param error |
| 1002 | content type error |
| 1003 | image not exists |
| 1004 | image size error |
| 1005 | image format error |
| 1006 | invalid signature |
| 1007 | body size error |
| 1008 | no authorization |
| 2000 | server unknown error |
| 2001 | server timeout |
| 2003 | no content recognition |
| 2004 | validate data error |
| 3000 | remote server error |
| 4000 | base server error |
Os API messages são exibidos com os valores brutos do serviço upstream para corresponder exatamente às respostas de produção.
Planos de Preços API
Mais barato do que pacotes de créditos avulsos. As assinaturas continuam sendo a opção de menor custo para uso recorrente.
Desenvolvedor
Ideal para avaliação e integração inicial
- Autenticação com Bearer token
- Resultado de falsificação, confiança, heatmap e coordenadas de região
- Feito para fluxos de revisão de documentos e imagens adulterados
- Acesso ao endpoint e ao token no painel após a compra
Crescimento
Ideal para pilotos em produção e uso estável
- Autenticação com Bearer token
- Resultado de falsificação, confiança, heatmap e coordenadas de região
- Feito para fluxos de revisão de documentos e imagens adulterados
- Acesso ao endpoint e ao token no painel após a compra
Escala
Ideal para fluxos em lote e equipes com vários projetos
- Autenticação com Bearer token
- Resultado de falsificação, confiança, heatmap e coordenadas de região
- Feito para fluxos de revisão de documentos e imagens adulterados
- Acesso ao endpoint e ao token no painel após a compra
Negócios
Ideal para cargas de produção de longo prazo
- Autenticação com Bearer token
- Resultado de falsificação, confiança, heatmap e coordenadas de região
- Feito para fluxos de revisão de documentos e imagens adulterados
- Acesso ao endpoint e ao token no painel após a compra
Por que desenvolvedores confiam em nossa API
Construída para cargas de trabalho de produção, nossa API de detecção de falsificações equilibra qualidade, desempenho e custo para que você possa confiar nela em aplicações reais.
Confiabilidade pronta para produção
Alta disponibilidade e desempenho estável otimizado para tráfego real.
Otimizado para detecção de falsificações
Modelos focados em documentos, certificados e faturas com detecção de manipulação para resultados mais consistentes.
Preços previsíveis, apenas API
Planos API dedicados com custos claros por crédito para integrações de longo prazo.
Suporte quando você precisar
Suporte por email para ajudá-lo a diagnosticar problemas e melhorar sua integração ao longo do tempo.
1 crédito de API = 1 solicitação de API. O preço da API é menor do que o dos pacotes de créditos avulsos, enquanto as assinaturas continuam sendo a opção mais econômica para uso contínuo.