API Documentation

POST /login

Authenticate and receive a JWT access token.

Headers

JSON Body

Response

{
  "access_token": "eyJhbGciOiJIUzI1NiIs..."
}

POST /detect-img

Analyze an image for AI-generated content. Supports two modes: image URL (query parameter) or file upload (multipart form). One input per request: a file or a URL, never both (400).

Headers

Option A: Image URL

curl -X POST "https://api.isitai.com/detect-img?image_url=https://example.com/photo.jpg" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "accept: application/json"

Option B: File Upload

curl -X POST https://api.isitai.com/detect-img \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "accept: application/json" \
  -F "file=@/path/to/image.jpg"

Response

{
  "predicted_label": "AI",
  "probability": 0.92,
  "potential_method": "midjourney",
  "method_probability": 0.85,
  "NSFW": "No",
  "NSFW_probability": 0.02
}

POST /detect-img/batch

Check up to 20 images in one request, 1 credit each. Upload them as files, or send image_urls as a comma-separated list. If one image cannot be read or downloaded, the whole request fails with 400 and nothing is charged. A failed image, or one you have no credits left for, is not charged. Match the results to your images by index.

curl -X POST https://api.isitai.com/detect-img/batch \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "files=@/path/to/first.jpg" \
  -F "files=@/path/to/second.png"

{
  "results": [
    { "index": 0, "success": true, "predicted_label": "AI", "probability": 0.92, ... },
    { "index": 1, "success": false, "error": "Monthly quota exhausted and no credits available", "code": "QUOTA_EXHAUSTED" }
  ],
  "quota": { "monthly_limit": 200, "monthly_used": 200, "monthly_remaining": 0, "credits_remaining": 0 }
}

Face swap option (face_swap=true)

Adds the face swap check to an image check: did someone swap or fake a real person's face? The check uses 2 credits instead of 1. Only useful for images with people. Works the same on /detect-img/batch (2 credits per image).

POST /detect-video

Checks a video shorter than 60 s (up to 50 MB; MP4, MOV, WebM, MKV or AVI) one frame every 2 seconds. Videos are analyzed one at a time, so the check goes into a queue: the answer is the result, or 202 with a job_id to poll. Price: 6 credits for each started 10 s (12 with face_swap=true), counted in whole seconds, rounded down. You can have 3 videos queued or running at a time; a fourth gets 429 TOO_MANY_VIDEO_JOBS. Send a file or a video_url, never both (400).

curl -X POST "https://api.isitai.com/detect-video?wait=30" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@/path/to/clip.mp4"

Queued

{
  "job_id": 48213,
  "status": "queued",
  "position": 2,
  "duration_seconds": 23,
  "poll_url": "/detect-video/48213",
  "quota": { "credits_used": 18, ... }
}

The credits are taken when the job is queued and come back if it fails. Save the job_id at once.

GET /detect-video/{job_id}

Where a video check stands: 202 while it is queued or running (with its place in line), 200 with the result, 410 if the result was deleted (90 days after the check), or the stored error of a failed job (its credits were refunded). Poll every few seconds. You can read only your own jobs: any other job_id gets 404.

Result

{
  "predicted_label": "AI",
  "probability": 0.95,
  "potential_method": "sora",
  "NSFW": "No",
  "frames_checked": 12,
  "frames": [
    { "time_seconds": 0.0, "ai_probability": 0.08, "NSFW_probability": 0.01 },
    { "time_seconds": 2.0, "ai_probability": 0.95, "NSFW_probability": 0.01 },
    ...
  ],
  "job_id": 48213,
  "quota": { "credits_used": 18, ... }
}

The highest frame decides each verdict: one AI frame is enough to call the video AI-generated. With face_swap=true, the answer also has face_swap and face_swap_probability, and so does each frame.

Optional parts of a video result:

GET /pricing

The price of every kind of check, in credits. No token needed. audio is the music check: 1 credit per started minute, at most 5.

{
  "image": { "credits": 1, "with_face_swap": 2 },
  "video": {
    "credits_per_started_10_seconds": 6,
    "face_swap_factor": 2,
    "max_seconds": 60,
    "max_megabytes": 50,
    "examples": { "10s": 6, "30s": 18, "59s": 36, "30s_with_face_swap": 36 }
  },
  "audio": {
    "credits_per_started_minute": 1,
    "max_megabytes": 20,
    "examples": { "30s": 1, "3m20s": 4 },
    ...
  },
  "notes": "Lengths are counted in whole seconds, rounded down. A failed detection does not use credits."
}

POST /detect-audio

Checks whether a music track was made with AI, with a score for every 10 seconds and separate scores for vocals and instruments. Made for music: not for speech, podcasts or voice clones. Send a file or an audio_url, never both (400). Files: MP3, WAV, FLAC, OGG, OPUS, M4A or MP4 audio (no WebM), 10 s or longer, up to 20 MB. Only the first 300 s are checked. Price: 1 credit for each started minute, at most 5, counted in whole seconds, rounded down. The answer comes back in the same request.

curl -X POST https://api.isitai.com/detect-audio \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@/path/to/song.mp3"

Result

{
  "predicted_label": "AI",
  "probability": 0.92,
  "ai_music_probability": 0.92,
  "music_verdict": "pure_ai",
  "potential_method": "suno",
  "vocal_ai_probability": 0.75,
  "instrumental_ai_probability": 0.94,
  "analyzed_seconds": 200,
  "duration_seconds": 200,
  "chunks": [
    { "start_seconds": 0, "ai_music_probability": 0.88, "pure_ai_probability": 0.81 },
    { "start_seconds": 10, "ai_music_probability": 0.91, "pure_ai_probability": 0.84 },
    ...
  ],
  "quota": { "credits_used": 4, ... }
}

Errors

GET /consumption/

Retrieve the total number of credits your account has used, all time (website and API together).

Headers

curl https://api.isitai.com/consumption/ \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response

{
  "username": "you@example.com",
  "consumption": 142
}

POST /revoke-token

Revoke the token you send. After revocation, you will need a new key or a new token from /login.

Headers

curl -X POST https://api.isitai.com/revoke-token \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response

{
  "message": "Token revoked successfully!"
}