Detección de Falsificación de Imágenes
API

Detecte falsificaciones en cualquier imagen con 1 llamada API

Ejemplos de Solicitud y Respuesta

Use estos ejemplos para construir y depurar su integración

Ejemplo de Solicitud HTTP

POST https://{your-api-domain}/forgery_detection
Encabezados:
  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"
}

Ejemplos de Respuesta

Respuesta exitosa

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"
}

Respuesta de error comercial

Cuando el servicio upstream reporta un error comercial, la API devuelve error = "API_ERROR" y un código distinto de cero. Puede mapear este código usando la tabla de códigos de error a continuación.

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."
}

Introducción API

La tecnología de Inteligencia Artificial especializada en detección de falsificación de imágenes se ha vuelto más fácil que nunca usando la API de ImgAuth.com. Con solo unas pocas líneas de código, puede llevar esta tecnología a su aplicación.

Comprar Paquete

Compre un paquete dedicado a la API

Recibir Email API

Dentro de 2 horas después de su compra, recibirá un email con su dominio API dedicado y AppCode.

Usar Ejemplos de Código

Use los siguientes ejemplos de código para comenzar rápidamente

Ajustar Parámetros

Vuelva a la referencia de parámetros para ajustar la solicitud

Autenticación

Autenticamos solicitudes usando un dominio API dedicado y un token Bearer por cuenta. Después de comprar un paquete API, le enviaremos un email con su dominio API único y token. Por razones de seguridad, por favor no publique su token API.

Endpoint API

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

Reemplace {your-api-domain} con el dominio API que le enviamos por email después de la compra. Cada desarrollador tiene un dominio y token dedicados.

Encabezados

Autorización:

Bearer {YOUR_API_TOKEN}

Reemplace {YOUR_API_TOKEN} con el token Bearer que le enviamos por email. Manténgalo secreto y nunca lo suba a repositorios públicos.

Content-Type:

application/json; charset=UTF-8

Ejemplos de Código

Comience rápidamente con nuestros ejemplos 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 Solicitud

Configure sus solicitudes API con estos parámetros

Parámetro	Tipo	Descripción
image	string	Base64 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.
url	string	Complete 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_heatmap	string	Whether to return forgery region heatmap. Default: false. true: returns base64-encoded heatmap, false: does not return
detect_proportion	string	Whether to return image tampering confidence. Default: false. true: returns tampering confidence, false: does not return
restrict_probability	string	Threshold 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

Parameter	Type	Description
detection_result	string	Tampering detection result: "fake" indicates tampering detected, "real" indicates no tampering
tampered_proportion	float	Image tampering confidence (returned when detect_proportion = true in request)
heatmap	string	Base64-encoded heatmap of tampered regions (returned when return_heatmap = true in request)
tampered_location	array	Array of forgery region coordinate information (returned when probability ≥ restrict_probability threshold). Each item contains: left, top, width, height (coordinates), and probability (confidence score)
left	uint32	Horizontal coordinate of the top-left vertex of the forgery region
top	uint32	Vertical coordinate of the top-left vertex of the forgery region
width	uint32	Width of the forgery region
height	uint32	Height of the forgery region
probability	float	Confidence score indicating the probability of forgery in this region

Códigos de Error

Referencia para códigos de respuesta API

Código de Error	Mensaje de Error	Descripción
0	success	Success
1000	body error	Request body error
1001	param error	Request parameter error
1002	content type error	Content-Type error
1003	image not exists	Image file not found
1004	image size error	Image size error
1005	image format error	Image format error
1006	invalid signature	Invalid signature
1007	body size error	Body size error
1008	no authorization	Authorization failed
2000	server unknown error	Server unknown error
2001	server timeout	Server timeout
2003	no content recognition	No content recognized
2004	validate data error	Validation data error
3000	remote server error	Remote server error
4000	base server error	Base server error

Planes de Precios API

Los siguientes planes son exclusivos para API

Starter

$99$0.198 / Crédito

500 créditos

Validez de 3 meses

Soporta la mayoría de formatos de imagen
Corrección y mejora de documentos
Detección de falsificaciones de documentos
Eliminación de patrón moiré de imagen
Velocidad de procesamiento ~2 segundos

Más Popular

Business

$749$0.05 / Crédito

15,000 créditos

Validez de 1 año

Soporta la mayoría de formatos de imagen
Corrección y mejora de documentos
Detección de falsificaciones de documentos
Eliminación de patrón moiré de imagen
Velocidad de procesamiento ~2 segundos

Exclusivo

Enterprise

$1999$0.04 / Crédito

50,000 créditos

Validez de 1 año

Soporta la mayoría de formatos de imagen
Corrección y mejora de documentos
Detección de falsificaciones de documentos
Eliminación de patrón moiré de imagen
Velocidad de procesamiento ~2 segundos

Por qué los desarrolladores confían en nuestra API

Construida para cargas de trabajo de producción, nuestra API de detección de falsificaciones equilibra calidad, rendimiento y costo para que pueda confiar en ella en aplicaciones del mundo real.

Confiabilidad lista para producción

Alta disponibilidad y rendimiento estable optimizado para tráfico real.

Optimizado para detección de falsificaciones

Modelos enfocados en documentos, certificados y facturas con detección de manipulación para resultados más consistentes.

Precios predecibles, solo API

Planes API dedicados con costos claros por crédito para integraciones a largo plazo.

Soporte cuando lo necesite

Soporte por email para ayudarle a diagnosticar problemas y mejorar su integración con el tiempo.

Elegir Plan API Ver Política de Reembolso

Detección de Falsificación de ImágenesAPI