DEVELOPER API / V1

开发者 API

将 AI 图片检测接入你的应用。上传单张图片，获得检测分数与判断结果。

管理 API 密钥 →API 文档

$14.99

购买一次 Developer 永久解锁 API，之后可购买任意积分包补充余额。

1,500

付费积分

API 每次成功检测消耗 1 个付费积分；每日免费检测仅适用于网页。

JPEG · PNG · WebP

10 MiB / 40 MP

检测结果是估计值，不能作为真伪证明。

快速开始

API 密钥属于机密，仅用于服务端。

cURL

curl 'https://isthisimageai.org/api/v1/detect' \
  -H "Authorization: Bearer $ISTHISIMAGE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -F 'image=@photo.jpg'

Python

import os, uuid, requests

with open("photo.jpg", "rb") as image:
    response = requests.post(
        "https://isthisimageai.org/api/v1/detect",
        headers={"Authorization": "Bearer " + os.environ["ISTHISIMAGE_API_KEY"],
                 "Idempotency-Key": str(uuid.uuid4())},
        files={"image": ("photo.jpg", image, "image/jpeg")}, timeout=120)
print(response.status_code, response.json())

Node.js

import { readFile } from 'node:fs/promises';

const form = new FormData();
form.set('image', new Blob([await readFile('photo.jpg')], { type: 'image/jpeg' }), 'photo.jpg');
const response = await fetch('https://isthisimageai.org/api/v1/detect', {
  method: 'POST',
  headers: { Authorization: 'Bearer ' + process.env.ISTHISIMAGE_API_KEY,
             'Idempotency-Key': crypto.randomUUID() },
  body: form
});
console.log(response.status, await response.json());

{"ok":true,"request_id":"…","result":{"score":0.92,"verdict":"likely_ai"},"credits_charged":1,"remaining_credits":1499}

用量与限制

API 每次成功检测消耗 1 个付费积分；每日免费检测仅适用于网页。

POST /api/v1/detect: 10 / min · 2 concurrent
GET /api/v1/usage: 60 / min
Idempotency-Key: UUID v4

Developer 订单发生已确认退款后，该笔购买授予的 API 权限将被撤回。

Markdown ↗OpenAPI 3.1 ↗补充积分 →

400	`INVALID_REQUEST / INVALID_IMAGE`
401	`INVALID_API_KEY`
402	`INSUFFICIENT_CREDITS`
403	`API_ACCESS_REQUIRED`
409	`IDEMPOTENCY_CONFLICT`
409	`REQUEST_IN_PROGRESS`
409	`CONCURRENCY_LIMIT`
413	`IMAGE_TOO_LARGE`
415	`UNSUPPORTED_IMAGE`
429	`RATE_LIMITED`
503	`API_UNAVAILABLE / DETECTOR_UNAVAILABLE`
504	`PROVIDER_TIMEOUT`
500	`INTERNAL_ERROR`