图像伪造检测
API

通过1次API调用检测任何图像中的伪造

请求和响应示例

使用这些示例来构建和调试您的集成

示例HTTP请求

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

示例响应

成功响应

当请求有效且图像成功处理时，API返回detection_result，指示图像是否被篡改（fake）或真实（real），以及可选的篡改置信度、热力图和位置坐标。

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

业务错误响应

当上游服务报告业务错误时，API返回错误 = "API_ERROR"和非零代码。您可以使用下面的错误代码表映射此代码。

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

API 介绍

专门用于图像伪造检测的人工智能技术通过使用ImgAuth.com API变得比以往任何时候都更容易。只需几行代码，您就可以将此技术引入您的应用程序。

购买套餐

购买专用于API的套餐

接收API邮件

购买后2小时内，您将收到一封包含您的专用API域名和AppCode的电子邮件。

使用代码示例

使用以下代码示例快速开始

调整参数

返回参数参考以调整请求

身份验证

我们使用专用API域名和每个账户的Bearer令牌来验证请求。购买API套餐后，我们将向您发送包含您唯一API域名和令牌的电子邮件。出于安全原因，请不要发布您的API令牌。

API端点

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

将{your-api-domain}替换为购买后我们通过电子邮件发送给您的API域名。每个开发人员都有专用的域名和令牌。

请求头

授权:

Bearer {YOUR_API_TOKEN}

将{YOUR_API_TOKEN}替换为我们通过电子邮件发送给您的Bearer令牌。请保密，永远不要将其提交到公共存储库。

Content-Type:

application/json; charset=UTF-8

代码示例

使用我们的代码示例快速开始

#!/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"

请求参数

使用这些参数配置您的API请求

参数	类型	描述
image	string	Base64编码的图片数据，需urlencode。大小不超过10MB。最短边至少512px，最长边最大8192px。支持jpg/jpeg/png/bmp格式。image和url二选一。
url	string	图片完整URL，长度不超过1024字节。图片base64编码后大小不超过10MB。最短边至少512px，最长边最大8192px。支持jpg/jpeg/png/bmp格式。image和url二选一。请注意关闭URL防盗链。
return_heatmap	string	是否返回伪造区域热力图。默认：false。true：返回base64编码的热力图，false：不返回
detect_proportion	string	是否返回图片篡改置信度。默认：false。true：返回图片篡改置信度，false：不返回
restrict_probability	string	返回伪造区域坐标的阈值，范围0.1～1，仅支持1位小数点，默认为0.8。当伪造区域坐标置信度分数（probability）≥ 阈值时，tampered_location返回符合阈值的坐标信息，反之不返回该坐标信息

响应参数

API响应字段参考

参数	类型	描述
detection_result	string	篡改检测结果："fake"表示检测到篡改，"real"表示无篡改
tampered_proportion	float	图片篡改置信度（当请求参数detect_proportion = true时返回）
heatmap	string	篡改区域热力图（当请求参数return_heatmap = true时返回）
tampered_location	array	伪造区域的坐标信息数组（当probability ≥ restrict_probability阈值时返回坐标信息）。每个项目包含：left、top、width、height（坐标）和probability（置信度分数）
left	uint32	表示伪造区域的左上顶点的水平坐标
top	uint32	表示伪造区域的左上顶点的垂直坐标
width	uint32	表示伪造区域的宽度
height	uint32	表示伪造区域的高度
probability	float	标识该区域伪造置信度分数

错误代码

API响应代码参考

错误代码	错误消息	描述
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

API定价计划

以下计划专用于API

Starter

$99$0.198 / 积分

500积分

3个月有效期

支持大多数图像格式
文档校正和增强
文档伪造检测
图像摩尔纹图案去除
处理速度 ~2秒

最受欢迎

Business

$749$0.05 / 积分

15,000积分

1年有效期

支持大多数图像格式
文档校正和增强
文档伪造检测
图像摩尔纹图案去除
处理速度 ~2秒

独家

Enterprise

$1999$0.04 / 积分

50,000积分

1年有效期

支持大多数图像格式
文档校正和增强
文档伪造检测
图像摩尔纹图案去除
处理速度 ~2秒

为什么开发人员信任我们的API

专为生产工作负载构建，我们的伪造检测API平衡了质量、性能和成本，因此您可以在实际应用中依赖它。

生产就绪的可靠性

针对实际流量优化的高可用性和稳定性能。

针对伪造检测优化

专注于文档、证书和发票的模型，具有篡改检测功能，以获得更一致的结果。

可预测的、仅API定价

专用于长期集成的API计划，具有明确的每积分成本。

需要时提供支持

电子邮件支持，帮助您诊断问题并随着时间的推移改进您的集成。

选择API计划查看退款政策

图像伪造检测API