请求和响应示例
使用这些示例来构建和调试您的集成
示例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变得比以往任何时候都更容易。只需几行代码，您就可以将此技术引入您的应用程序。
1
选择 API 积分包
选择适合你集成调用量的 API 积分套餐
2
获取 API 访问权限
购买后可在账户仪表盘查看 API Key 和端点
3
使用代码示例
使用以下代码示例快速开始
4
上线使用
监控用量、调整请求参数并投入生产
身份验证
使用账户中的 API 端点和 Bearer Token 进行认证。购买 API 积分后，可在账户仪表盘查看端点和令牌。请妥善保管令牌，不要提交到公开仓库。
API端点
POST https://{your-api-domain}/forgery_detection
请将 {your-api-domain} 替换为账户仪表盘中显示的 API 端点。
请求头
授权:
Bearer {YOUR_API_TOKEN}
请将 {YOUR_API_TOKEN} 替换为账户仪表盘中显示的 Bearer Token。请妥善保管，不要提交到公开仓库。
Content-Type:
application/json; charset=UTF-8
代码示例
使用我们的代码示例快速开始
#!/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"请求参数
使用这些参数配置您的API请求
| 参数 | 类型 | 描述 |
|---|---|---|
| image | string | Base64 编码后的图像数据，需进行 URL 编码。最大 10 MB。最短边至少 512 px，最长边最多 8192 px。支持 jpg/jpeg/png/bmp。image 和 url 二选一。 |
| url | string | 完整图片 URL，长度不超过 1024 字节。编码后的图片大小需控制在 10 MB 以内。最短边至少 512 px，最长边最多 8192 px。支持 jpg/jpeg/png/bmp。image 和 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 | 篡改区域的 Base64 热力图，在 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 |
| 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 |
API message 保留上游原始返回值，便于与你在生产环境中看到的响应保持一致。
API定价计划
相比一次性 credits 更优惠；订阅方案仍然是长期高频使用的最低成本选择。
开发者
$99
500 积分
12 个月有效
适合评估与早期接入
- Bearer Token 身份验证
- 返回篡改结果、置信度、热力图与区域坐标
- 适用于文档与图像篡改审核工作流
- 购买后可在仪表盘查看 API 端点和令牌
最受欢迎
增长
$359
2,000 积分
12 个月有效
适合生产试点与稳定调用
- Bearer Token 身份验证
- 返回篡改结果、置信度、热力图与区域坐标
- 适用于文档与图像篡改审核工作流
- 购买后可在仪表盘查看 API 端点和令牌
规模
$899
5,000 积分
12 个月有效
适合批量流程和多项目团队
- Bearer Token 身份验证
- 返回篡改结果、置信度、热力图与区域坐标
- 适用于文档与图像篡改审核工作流
- 购买后可在仪表盘查看 API 端点和令牌
最佳价值
商业
$2,499
15,000 积分
12 个月有效
适合长期生产环境负载
- Bearer Token 身份验证
- 返回篡改结果、置信度、热力图与区域坐标
- 适用于文档与图像篡改审核工作流
- 购买后可在仪表盘查看 API 端点和令牌