Detecção de Falsificação de Imagens
API

Detecte falsificações em qualquer imagem com 1 chamada API

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

When the request is valid and the image is processed successfully, the API returns detection_result indicating whether the image is tampered (fake) or authentic (real), along with optional tampering confidence, heatmap, and location coordinates.

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.

1

Comprar Pacote

Compre um pacote dedicado à API

2

Receber Email API

Dentro de 2 horas após sua compra, você receberá um email com seu domínio API dedicado e AppCode.

3

Usar Exemplos de Código

Use os seguintes exemplos de código para começar rapidamente

4

Ajustar Parâmetros

Volte à referência de parâmetros para ajustar a solicitação

Autenticação

Autenticamos solicitações usando um domínio API dedicado e um token Bearer por conta. Após comprar um pacote API, enviaremos um email com seu domínio API único e token. Por razões de segurança, por favor não publique seu token API.

Endpoint API

POST https://{your-api-domain}/forgery_detection

Substitua {your-api-domain} pelo domínio API que enviamos por email após a compra. Cada desenvolvedor tem um domínio e token dedicados.

Cabeçalhos

Autorização:
Bearer {YOUR_API_TOKEN}
Substitua {YOUR_API_TOKEN} pelo token Bearer que enviamos por email. Mantenha-o secreto e nunca o faça commit em repositórios públicos.
Content-Type:
application/json; charset=UTF-8

Exemplos de Código

Comece rapidamente com nossos exemplos de código

#!/usr/bin/env bash

set -euo pipefail

# Domain and token for the image processing proxy
API_DOMAIN="https://{your-api-domain}"
API_PATH="/forgery_detection"
API_TOKEN="{YOUR_API_TOKEN}"

# Image file passed as first argument (default: testpaper.jpg)
IMAGE_FILE="${1:-testpaper.jpg}"

if [ ! -f "$IMAGE_FILE" ]; then
  echo "Image file not found: $IMAGE_FILE" >&2
  echo "Usage: $0 path/to/image.jpg" >&2
  exit 1
fi

echo "Encoding image to Base64: $IMAGE_FILE"
# Encode image to Base64 and remove newlines (use -i for BSD base64 on macOS)
BASE64_IMAGE=$(base64 -i "$IMAGE_FILE" | tr -d '
')

echo "Building JSON body..."
read -r -d '' JSON_BODY <<EOF || true
{
  "image": "$BASE64_IMAGE",
  "return_heatmap": "false",
  "detect_proportion": "false",
  "restrict_probability": "0.8"
}
EOF

echo "Calling proxy API..."
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"

echo "Response saved to response.json"

Parâmetros de Solicitação

Configure suas solicitações API com estes parâmetros

ParâmetroTipoDescrição
imagestringBase64 encoded image data, urlencoded. Size must not exceed 10MB. Shortest side at least 512px, longest side max 8192px. Supports jpg/jpeg/png/bmp formats. Either image or url is required.
urlstringComplete image URL, length not exceeding 1024 bytes. Image size must not exceed 10MB after base64 encoding. Shortest side at least 512px, longest side max 8192px. Supports jpg/jpeg/png/bmp formats. Either image or url is required. Please disable URL hotlink protection.
return_heatmapstringWhether to return forgery region heatmap. Default: false. true: returns base64-encoded heatmap, false: does not return
detect_proportionstringWhether to return image tampering confidence. Default: false. true: returns tampering confidence, false: does not return
restrict_probabilitystringThreshold for returning forgery region coordinates. Range: 0.1 to 1, supports 1 decimal place. Default: 0.8. When forgery region coordinate confidence score (probability) ≥ threshold, tampered_location returns coordinates meeting the threshold, otherwise does not return coordinates

Response Parameters

Reference for API response fields

ParameterTypeDescription
detection_resultstringTampering detection result: "fake" indicates tampering detected, "real" indicates no tampering
tampered_proportionfloatImage tampering confidence (returned when detect_proportion = true in request)
heatmapstringBase64-encoded heatmap of tampered regions (returned when return_heatmap = true in request)
tampered_locationarrayArray of forgery region coordinate information (returned when probability ≥ restrict_probability threshold). Each item contains: left, top, width, height (coordinates), and probability (confidence score)
leftuint32Horizontal coordinate of the top-left vertex of the forgery region
topuint32Vertical coordinate of the top-left vertex of the forgery region
widthuint32Width of the forgery region
heightuint32Height of the forgery region
probabilityfloatConfidence score indicating the probability of forgery in this region

Códigos de Erro

Referência para códigos de resposta API

Código de ErroMensagem de ErroDescrição
0successSuccess
1000body errorRequest body error
1001param errorRequest parameter error
1002content type errorContent-Type error
1003image not existsImage file not found
1004image size errorImage size error
1005image format errorImage format error
1006invalid signatureInvalid signature
1007body size errorBody size error
1008no authorizationAuthorization failed
2000server unknown errorServer unknown error
2001server timeoutServer timeout
2003no content recognitionNo content recognized
2004validate data errorValidation data error
3000remote server errorRemote server error
4000base server errorBase server error

Planos de Preços API

Os seguintes planos são exclusivos para API

Starter

$99$0.198 / Crédito
500 créditos
Validade de 3 meses
  • Suporta a maioria dos formatos de imagem
  • Correção e melhoria de documentos
  • Detecção de falsificações de documentos
  • Remoção de padrão moiré da imagem
  • Velocidade de processamento ~2 segundos
Mais Popular

Popular

$349$0.07 / Crédito
5,000 créditos
Validade de 6 meses
  • Suporta a maioria dos formatos de imagem
  • Correção e melhoria de documentos
  • Detecção de falsificações de documentos
  • Remoção de padrão moiré da imagem
  • Velocidade de processamento ~2 segundos

Business

$749$0.05 / Crédito
15,000 créditos
Validade de 1 ano
  • Suporta a maioria dos formatos de imagem
  • Correção e melhoria de documentos
  • Detecção de falsificações de documentos
  • Remoção de padrão moiré da imagem
  • Velocidade de processamento ~2 segundos
Exclusivo

Enterprise

$1999$0.04 / Crédito
50,000 créditos
Validade de 1 ano
  • Suporta a maioria dos formatos de imagem
  • Correção e melhoria de documentos
  • Detecção de falsificações de documentos
  • Remoção de padrão moiré da imagem
  • Velocidade de processamento ~2 segundos

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.

API de Detecção de Falsificação de Imagens – Detecte Adulteração com IA