API de Detección de Falsificación de Imágenes
Acceso para desarrolladores
Detecta manipulación de documentos e imágenes con una API REST lista para producción.
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
Cuando la solicitud es válida y la imagen se procesa correctamente, la API devuelve detection_result para indicar si la imagen está manipulada (fake) o es auténtica (real), junto con la confianza, el heatmap y las coordenadas cuando se solicitan.
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.
Elige créditos de API
Selecciona el paquete de créditos de API que se ajuste a tu volumen de integración
Obtén acceso a la API
Después de la compra, consulta tu clave API y endpoint en el panel de tu cuenta
Usar Ejemplos de Código
Use los siguientes ejemplos de código para comenzar rápidamente
Lanza a producción
Supervisa el uso, ajusta los parámetros y pasa a producción
Autenticación
Autentica las solicitudes con el endpoint de API de tu cuenta y un token Bearer. Después de comprar créditos de API, puedes ver tu endpoint y token en el panel de tu cuenta. Mantén tu token en secreto y nunca lo subas a repositorios públicos.
Endpoint API
Sustituye {your-api-domain} por el endpoint de API mostrado en el panel de tu cuenta.
Encabezados
Ejemplos de Código
Comience rápidamente con nuestros ejemplos 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 Solicitud
Configure sus solicitudes API con estos parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
| image | string | Datos de imagen codificados en Base64 y luego URL-encodeados. Máximo 10 MB. Lado más corto de al menos 512 px y lado más largo de como máximo 8192 px. Soporta jpg/jpeg/png/bmp. Proporcione image o url. |
| url | string | URL completa de la imagen, con un máximo de 1024 bytes. La imagen codificada debe mantenerse por debajo de 10 MB. Lado más corto de al menos 512 px y lado más largo de como máximo 8192 px. Soporta jpg/jpeg/png/bmp. Proporcione image o url y desactive la protección anti-hotlink. |
| return_heatmap | string | Indica si se devuelve un heatmap de falsificación. Valor predeterminado: false. true devuelve un heatmap en Base64, false lo omite. |
| detect_proportion | string | Indica si se devuelve la puntuación de confianza de manipulación. Valor predeterminado: false. true devuelve la puntuación, false la omite. |
| restrict_probability | string | Umbral para devolver coordenadas de falsificación. Rango: 0.1 a 1 con 1 decimal. Valor predeterminado: 0.8. tampered_location solo se devuelve cuando probability alcanza o supera ese umbral. |
Parámetros de respuesta
Referencia de los campos de respuesta de la API
| Parámetro | Tipo | Descripción |
|---|---|---|
| detection_result | string | Resultado de manipulación: "fake" significa que se detectó manipulación y "real" significa que no se detectó manipulación. |
| tampered_proportion | float | Puntuación de confianza de manipulación, devuelta cuando detect_proportion = true. |
| heatmap | string | Heatmap Base64 de las regiones manipuladas, devuelto cuando return_heatmap = true. |
| tampered_location | array | Matriz de coordenadas de regiones sospechosas, devuelta cuando probability es mayor o igual que restrict_probability. Cada elemento incluye left, top, width, height y probability. |
| left | uint32 | Coordenada horizontal de la esquina superior izquierda de la región sospechosa. |
| top | uint32 | Coordenada vertical de la esquina superior izquierda de la región sospechosa. |
| width | uint32 | Ancho de la región sospechosa. |
| height | uint32 | Alto de la región sospechosa. |
| probability | float | Puntuación de confianza para esta región sospechosa. |
Códigos de Error
Referencia para códigos de respuesta API
| Código de Error | Mensaje de Error |
|---|---|
| 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 |
Los API messages se muestran con sus valores brutos del servicio ascendente para coincidir exactamente con las respuestas de producción.
Planes de Precios API
Más económico que los créditos de un solo pago. Las suscripciones siguen siendo la opción de menor costo para uso recurrente.
Desarrollador
Ideal para evaluación e integración inicial
- Autenticación con token Bearer
- Resultado de falsificación, confianza, heatmap y coordenadas de región
- Diseñado para flujos de revisión de documentos e imágenes manipulados
- Acceso al endpoint API y al token desde el panel después de la compra
Crecimiento
Ideal para pilotos en producción y uso estable
- Autenticación con token Bearer
- Resultado de falsificación, confianza, heatmap y coordenadas de región
- Diseñado para flujos de revisión de documentos e imágenes manipulados
- Acceso al endpoint API y al token desde el panel después de la compra
Escala
Ideal para flujos por lotes y equipos con varios proyectos
- Autenticación con token Bearer
- Resultado de falsificación, confianza, heatmap y coordenadas de región
- Diseñado para flujos de revisión de documentos e imágenes manipulados
- Acceso al endpoint API y al token desde el panel después de la compra
Empresa
Ideal para cargas de trabajo de producción a largo plazo
- Autenticación con token Bearer
- Resultado de falsificación, confianza, heatmap y coordenadas de región
- Diseñado para flujos de revisión de documentos e imágenes manipulados
- Acceso al endpoint API y al token desde el panel después de la compra
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.
1 crédito API = 1 solicitud API. El precio de la API es inferior al de los paquetes de créditos de un solo pago, mientras que las suscripciones siguen siendo la opción más económica para uso continuo.