Image

Python

import os, requests


# Set API key ENV variable or replace with your own API key
API_KEY=os.getenv("AIORNOT_API_KEY")
IMAGE_ENDPOINT = "https://api.aiornot.com/v2/image/sync"

# By default, ai_generated, deepfake, nsfw, and quality reports run.
# Use 'only' and 'excluding' parameters to select subsets.
# Note: ai_generated and deepfake have their own costs.

with open("image.jpeg", "rb") as f:
    resp = requests.post(
        IMAGE_ENDPOINT,
        headers={"Authorization": f"Bearer {API_KEY}"},
        files={"image": f},
        params={
            "external_id": "my-tracking-id"  # Optional
            # Example: only run reverse_search:
            # "only": ["reverse_search"]
            # Example: run all defaults except deepfake:
            # "excluding": ["deepfake"]
        }
    )
    resp.raise_for_status()
    print(resp.json())

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "report": {
    "meta": {
      "width": 640,
      "height": 480,
      "format": "jpeg",
      "size_bytes": 102400,
      "md5": "a1b2c3d4e5f6789012345678901234567",
      "processing_status": {
        "ai_generated": "processed",
        "deepfake": "processed",
        "nsfw": "processed",
        "quality": "processed"
      }
    },
    "ai_generated": {
      "verdict": "ai",
      "ai": {
        "is_detected": true,
        "confidence": 0.95
      },
      "human": {
        "is_detected": false,
        "confidence": 0.05
      },
      "generator": {
        "midjourney": 0.95,
        "dall_e": 0.95,
        "stable_diffusion": 0.95,
        "this_person_does_not_exist": 0.95,
        "adobe_firefly": 0.95,
        "flux": 0.95,
        "four_o": 0.95
      }
    },
    "deepfake": {
      "is_detected": true,
      "confidence": 0.95,
      "rois": [
        {
          "is_detected": true,
          "confidence": 0.95,
          "bbox": {
            "x1": 120,
            "y1": 85,
            "x2": 380,
            "y2": 295
          }
        }
      ]
    },
    "nsfw": {
      "is_detected": true,
      "version": "1.0.0"
    },
    "quality": {
      "is_detected": true
    },
    "reverse_search": {
      "was_found": true,
      "matches": [
        {
          "domain": "cnet.com",
          "image_url": "https://img.tineye.com/result/59752e592ddca832cb36bf200135b4f30f6fadca2ea4acc7c63f8dd231463c72-43",
          "width": 196,
          "height": 147,
          "earliest_crawl_date": "2021-03-26",
          "earliest_backlink": "https://www.cnet.com/topics/internet-culture/2/"
        }
      ]
    }
  },
  "created_at": "2023-11-07T05:31:56Z",
  "external_id": "<string>"
}

POST

image

sync

Python

import os, requests


# Set API key ENV variable or replace with your own API key
API_KEY=os.getenv("AIORNOT_API_KEY")
IMAGE_ENDPOINT = "https://api.aiornot.com/v2/image/sync"

# By default, ai_generated, deepfake, nsfw, and quality reports run.
# Use 'only' and 'excluding' parameters to select subsets.
# Note: ai_generated and deepfake have their own costs.

with open("image.jpeg", "rb") as f:
    resp = requests.post(
        IMAGE_ENDPOINT,
        headers={"Authorization": f"Bearer {API_KEY}"},
        files={"image": f},
        params={
            "external_id": "my-tracking-id"  # Optional
            # Example: only run reverse_search:
            # "only": ["reverse_search"]
            # Example: run all defaults except deepfake:
            # "excluding": ["deepfake"]
        }
    )
    resp.raise_for_status()
    print(resp.json())

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "report": {
    "meta": {
      "width": 640,
      "height": 480,
      "format": "jpeg",
      "size_bytes": 102400,
      "md5": "a1b2c3d4e5f6789012345678901234567",
      "processing_status": {
        "ai_generated": "processed",
        "deepfake": "processed",
        "nsfw": "processed",
        "quality": "processed"
      }
    },
    "ai_generated": {
      "verdict": "ai",
      "ai": {
        "is_detected": true,
        "confidence": 0.95
      },
      "human": {
        "is_detected": false,
        "confidence": 0.05
      },
      "generator": {
        "midjourney": 0.95,
        "dall_e": 0.95,
        "stable_diffusion": 0.95,
        "this_person_does_not_exist": 0.95,
        "adobe_firefly": 0.95,
        "flux": 0.95,
        "four_o": 0.95
      }
    },
    "deepfake": {
      "is_detected": true,
      "confidence": 0.95,
      "rois": [
        {
          "is_detected": true,
          "confidence": 0.95,
          "bbox": {
            "x1": 120,
            "y1": 85,
            "x2": 380,
            "y2": 295
          }
        }
      ]
    },
    "nsfw": {
      "is_detected": true,
      "version": "1.0.0"
    },
    "quality": {
      "is_detected": true
    },
    "reverse_search": {
      "was_found": true,
      "matches": [
        {
          "domain": "cnet.com",
          "image_url": "https://img.tineye.com/result/59752e592ddca832cb36bf200135b4f30f6fadca2ea4acc7c63f8dd231463c72-43",
          "width": 196,
          "height": 147,
          "earliest_crawl_date": "2021-03-26",
          "earliest_backlink": "https://www.cnet.com/topics/internet-culture/2/"
        }
      ]
    }
  },
  "created_at": "2023-11-07T05:31:56Z",
  "external_id": "<string>"
}

Authorizations

Authorization

string

header

required

Your API key as the Bearer token in the Authorization header.

Query Parameters

only

enum<string>[]

Array of analysis types to include. Valid values are ai_generated, deepfake, nsfw, quality, reverse_search.

Available options:

ai_generated,

deepfake,

nsfw,

quality,

reverse_search

excluding

enum<string>[]

Array of analysis types to exclude. Valid values are ai_generated, deepfake, nsfw, quality, reverse_search.

Available options:

ai_generated,

deepfake,

nsfw,

quality,

reverse_search

external_id

string | null

An optional external identifier for tracking this image analysis.

Body

multipart/form-data

image

file

required

The image file to analyze.

Supported formats: jpg, jpeg, png, webp, heic, heif, tiff.
Max file size: 10MB

Response

Successful Response

string<uuid>

required

Unique identifier associated with the request.

report

object

required

Show child attributes

report.meta

ImageMetadata · object

required

Show child attributes

report.meta.width

integer | null

required

Example:

640

report.meta.height

integer | null

required

Example:

480

report.meta.format

string | null

required

Example:

"jpeg"

report.meta.size_bytes

integer | null

required

Example:

102400

report.meta.md5

string | null

required

Example:

"a1b2c3d4e5f6789012345678901234567"

report.meta.processing_status

Processing Status · object

required

Show child attributes

report.meta.processing_status.{key}

enum<string>

Available options:

processed,

rejected,

errored

Example:

{
  "ai_generated": "processed",
  "deepfake": "processed",
  "nsfw": "processed",
  "quality": "processed"
}

report.ai_generated

AIONReportScheme · object

Show child attributes

report.ai_generated.verdict

enum<string>

required

The predicted class of the uploaded image.

This is the most important field in the response. This field is more reliable than directly using the confidence score yourself, as the confidence score may drift over time for new models.

Available options:

ai,

human,

unknown

report.ai_generated.ai

AIONPredictionBase · object

required

Show child attributes

report.ai_generated.ai.is_detected

boolean

required

Indicates whether the particular class was detected.

report.ai_generated.ai.confidence

number

required

Confidence score for the particular class.

Required range: 0 <= x <= 1

Example:

0.95

Example:

{ "is_detected": true, "confidence": 0.95 }

report.ai_generated.human

AIONPredictionBase · object

required

Show child attributes

report.ai_generated.human.is_detected

boolean

required

Indicates whether the particular class was detected.

report.ai_generated.human.confidence

number

required

Confidence score for the particular class.

Required range: 0 <= x <= 1

Example:

0.95

Example:

{ "is_detected": false, "confidence": 0.05 }

report.ai_generated.generator

AIONGeneratorScheme · object

required

A map of generator names to their prediction base.Please note that

This list is not exhaustive. We have trained on more generators than appear here.
We may add new generators at any time, so please make sure your integration allows for field addition without error.

Show child attributes

report.ai_generated.generator.midjourney

AIONPredictionBase · object

required

Show child attributes

report.ai_generated.generator.midjourney.is_detected

boolean

required

Indicates whether the particular class was detected.

report.ai_generated.generator.midjourney.confidence

number

required

Confidence score for the particular class.

Required range: 0 <= x <= 1

Example:

0.95

Example:

0.95

report.ai_generated.generator.dall_e

AIONPredictionBase · object

required

Show child attributes

report.ai_generated.generator.dall_e.is_detected

boolean

required

Indicates whether the particular class was detected.

report.ai_generated.generator.dall_e.confidence

number

required

Confidence score for the particular class.

Required range: 0 <= x <= 1

Example:

0.95

Example:

0.95

report.ai_generated.generator.stable_diffusion

AIONPredictionBase · object

required

Show child attributes

report.ai_generated.generator.stable_diffusion.is_detected

boolean

required

Indicates whether the particular class was detected.

report.ai_generated.generator.stable_diffusion.confidence

number

required

Confidence score for the particular class.

Required range: 0 <= x <= 1

Example:

0.95

Example:

0.95

report.ai_generated.generator.this_person_does_not_exist

AIONPredictionBase · object

required

Show child attributes

report.ai_generated.generator.this_person_does_not_exist.is_detected

boolean

required

Indicates whether the particular class was detected.

report.ai_generated.generator.this_person_does_not_exist.confidence

number

required

Confidence score for the particular class.

Required range: 0 <= x <= 1

Example:

0.95

Example:

0.95

report.ai_generated.generator.adobe_firefly

AIONPredictionBase · object

required

Show child attributes

report.ai_generated.generator.adobe_firefly.is_detected

boolean

required

Indicates whether the particular class was detected.

report.ai_generated.generator.adobe_firefly.confidence

number

required

Confidence score for the particular class.

Required range: 0 <= x <= 1

Example:

0.95

Example:

0.95

report.ai_generated.generator.flux

AIONPredictionBase · object

required

Show child attributes

report.ai_generated.generator.flux.is_detected

boolean

required

Indicates whether the particular class was detected.

report.ai_generated.generator.flux.confidence

number

required

Confidence score for the particular class.

Required range: 0 <= x <= 1

Example:

0.95

Example:

0.95

report.ai_generated.generator.four_o

AIONPredictionBase · object

required

Show child attributes

report.ai_generated.generator.four_o.is_detected

boolean

required

Indicates whether the particular class was detected.

report.ai_generated.generator.four_o.confidence

number

required

Confidence score for the particular class.

Required range: 0 <= x <= 1

Example:

0.95

Example:

0.95

report.deepfake

DeepFakeReportScheme · object

Show child attributes

report.deepfake.is_detected

boolean

required

Example:

true

report.deepfake.confidence

number

required

Required range: 0 <= x <= 1

Example:

0.95

report.deepfake.rois

RoisReportScheme · object[]

required

Show child attributes

report.deepfake.rois.is_detected

boolean

required

Example:

true

report.deepfake.rois.confidence

number

required

Required range: 0 <= x <= 1

Example:

0.95

report.deepfake.rois.bbox

BBoxScheme · object

required

Show child attributes

report.deepfake.rois.bbox.x1

integer

required

Example:

120

report.deepfake.rois.bbox.y1

integer

required

Example:

85

report.deepfake.rois.bbox.x2

integer

required

Example:

380

report.deepfake.rois.bbox.y2

integer

required

Example:

295

report.nsfw

NSFWReportScheme · object

Show child attributes

report.nsfw.is_detected

boolean

required

True if NSFW content found in the image. Please note that for us, the mere presence of a child is enough to trigger this flag. We offer a more granular NSFW report for clients who need it. Please contact us if this describes you.

report.nsfw.version

string

default:1.0.0

report.quality

QualityReportScheme · object

Show child attributes

report.quality.is_detected

boolean

required

Indicates whether the image is of high quality. Low quality (false) is not a asthetic judgement. It merely means that there are artifacts present that indicate things like excessive compression or blurring which degrades the performance of other classifiers (e.g. ai image detection).

report.reverse_search

ReverseSearchReportScheme · object

Show child attributes

report.reverse_search.was_found

boolean

required

Indicates whether matching images were found on the web

Example:

true

report.reverse_search.matches

ReverseSearchMatch · object[]

required

List of matching images found on the web

Show child attributes

report.reverse_search.matches.domain

string

required

The domain where the matching image was found

Example:

"cnet.com"

report.reverse_search.matches.image_url

string

required

URL of the matching image

Example:

"https://img.tineye.com/result/59752e592ddca832cb36bf200135b4f30f6fadca2ea4acc7c63f8dd231463c72-43"

report.reverse_search.matches.width

integer

required

Width of the matching image in pixels

Example:

196

report.reverse_search.matches.height

integer

required

Height of the matching image in pixels

Example:

147

report.reverse_search.matches.earliest_crawl_date

string

required

The earliest date this image was crawled (YYYY-MM-DD format)

Example:

"2021-03-26"

report.reverse_search.matches.earliest_backlink

string

required

URL of the earliest page where this image was found

Example:

"https://www.cnet.com/topics/internet-culture/2/"

created_at

string<date-time>

Date and time of request processing.

external_id

string | null

The external identifier provided in the request, if any.

Audio - Voice

⌘I

Reports by Modality

SYSTEM MANAGEMENT

Authorizations

Query Parameters

Body

Response