API 文档

AI 图片检测 API 完整参考：基础 URL、密钥认证、检测接口的请求参数与响应字段、置信度与生成器细分说明、错误码以及速率限制。

最近更新: 2026-07-16

AI 图片检测 API 提供单一接口，用于判断一张图片是否由 AI 生成，返回结论、概率评分、置信度，以及可选的各生成器来源分析。

基础 URL

所有接口均通过 HTTPS 提供，并以 /v1 路径前缀进行版本管理。

https://imagedetector.online/v1

认证

所有请求都需要付费账号，以及在 设置 → API 密钥 中创建的 API key。免费账号和未登录游客不能创建 API key，也不能调用 /v1 接口。以 Bearer token 方式在 Authorization 请求头中传入：

Authorization: Bearer sk_your_api_key

请求头	必填	说明
`Authorization`	是*	`Bearer sk_your_api_key`
`x-api-key`	是*	`sk_your_api_key`——`Authorization` 请求头的替代方式

*两者二选一即可。key 仅在创建时显示一次，请妥善保存。缺失或无效的 key 会返回 401 unauthorized。

检测图片

POST /v1/image/detect

发送 multipart 文件上传 或 包含公开图片 URL 的 JSON 请求体，二选一。

请求参数

参数	位置	类型	必填	说明
`image`	`multipart/form-data`	file	是*	待检测的图片文件（JPG、PNG 或 WebP，最大 8 MB）
`imageUrl`	`application/json`	string	是*	可公开访问的 HTTP/HTTPS 图片 URL

*每次请求 image 和 imageUrl 仅提供其一。

示例——文件上传

curl -X POST https://imagedetector.online/v1/image/detect \
  -H "Authorization: Bearer sk_your_api_key" \
  -F "image=@/path/to/photo.jpg"

import requests

resp = requests.post(
    "https://imagedetector.online/v1/image/detect",
    headers={"Authorization": "Bearer sk_your_api_key"},
    files={"image": open("/path/to/photo.jpg", "rb")},
)
print(resp.json())

const form = new FormData();
form.append('image', fs.createReadStream('/path/to/photo.jpg'));

const resp = await fetch('https://imagedetector.online/v1/image/detect', {
  method: 'POST',
  headers: { Authorization: 'Bearer sk_your_api_key' },
  body: form,
});
const data = await resp.json();

示例——图片 URL

curl -X POST https://imagedetector.online/v1/image/detect \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"imageUrl": "https://example.com/photo.jpg"}'

输入限制

限制项	取值
格式	JPG、PNG、WebP
最大体积	8 MB
URL 访问	必须能通过 HTTP/HTTPS 公开访问

响应

请求成功时返回 200 OK 及 JSON 响应体。

{
  "verdict": "likely_ai",
  "ai_score": 0.87,
  "confidence": "high",
  "source_breakdown": []
}

字段	类型	说明
`verdict`	string	`likely_ai`、`likely_human` 或 `uncertain`
`ai_score`	number	图片由 AI 生成的概率，取值 `0`–`1`
`confidence`	string	`low`、`medium` 或 `high`
`source_breakdown`	array	为未来的各生成器分数保留；当前版本始终为 `[]`

每次检测成功消耗 1 个额度，与网页工具共用同一余额。

错误

错误会返回带机器可读 error 代码、人类可读 message 和标准 HTTP 状态码的 JSON 响应体。

{ "error": "insufficient_credits", "message": "Insufficient credits" }

状态码	`error`	含义
`400`	`bad_request`	图片、URL 或格式缺失/无效
`401`	`unauthorized`	API key 缺失或无效
`402`	`insufficient_credits`	额度不足——请升级套餐
`403`	`paid_plan_required`	API 访问需要付费套餐
`429`	`too_many_requests`	超出速率限制——退避后重试
`503`	`unavailable`	检测服务未配置
`500`	`detection_failed`	服务端意外错误

速率限制

请求按 API key 进行速率限制，上限为 每秒 1 次请求。超出时会返回 429 too_many_requests，并带有 Retry-After 响应头（单位秒），指示需要等待多久后重试。

HTTP/1.1 429 Too Many Requests
Retry-After: 1

请在收到 429 时实现指数退避。需要更高吞吐？查看价格或就企业版限额联系我们。