Skip to content

Fileverity API docs

Image detections

Detect whether a whole image was generated by AI with POST /images/detections. One synchronous call: request and response fields, the answer values, limits and billing.

View as MarkdownUpdated 2026-11-11

POST /images/detections runs AI image detection. It tells you whether a whole image was generated by AI with vereye-2-detect, using the same models, Content Credentials, AI labels and watermarks as the image verification report (vereye-2), so both give the same answer on AI generation. It is synchronous: the result is in the response.

It does not examine local edits, including AI edits to part of a photo, and it returns no report ID or PDF. For edits, provenance and a record anyone can verify, create an analysis with vereye-2.

curl https://api.fileverity.com/v1/images/detections \  -H "Authorization: Bearer $FILEVERITY_API_KEY" \  -H "Idempotency-Key: 6b9d1c1e-3b0f-4c0a-9a53-2d1c9d6b7e11" \  -F file=@photo.jpg

Request body

Send the image as multipart/form-data in the field file, up to 4 MB. For larger images, up to 10 MB, upload with POST /files first and send JSON instead:

FieldTypeRequiredDescription
filefile or stringYesThe image in a multipart request, or the ID of an uploaded image in a JSON request. JPEG, PNG, WEBP, up to 40 megapixels. A file ID is consumed by the check.
modelstringNoDefault vereye-2-detect. Accepts the model ID or its snapshot ID vereye-2-detect-2026-10-30.

Unknown fields are rejected with invalid_parameter.

Response

{  "id": "idet_8Hk2pQ4vN9sL1xR7cW3mY6zB",  "object": "image.detection",  "created": 1794096000,  "model": "vereye-2-detect-2026-10-30",  "livemode": true,  "verdict": "ai_generated",  "ai": {    "key": "very_likely",    "basis": "detected",    "strength": "strong",    "likelihood": 100  },  "generator": null,  "signals": [    {      "id": "model_1",      "state": "ai"    },    {      "id": "model_2",      "state": "ai"    },    {      "id": "credentials",      "state": "none"    },    {      "id": "watermark",      "state": "none"    },    {      "id": "label",      "state": "none"    },    {      "id": "tool_data",      "state": "none"    },    {      "id": "camera",      "state": "none"    }  ],  "regions": [    {      "x": 0,      "y": 0,      "w": 576,      "h": 512,      "level": 3    },    {      "x": 576,      "y": 0,      "w": 384,      "h": 512,      "level": 3    },    {      "x": 960,      "y": 0,      "w": 576,      "h": 512,      "level": 2    },    {      "x": 0,      "y": 512,      "w": 576,      "h": 512,      "level": 3    },    {      "x": 576,      "y": 512,      "w": 384,      "h": 512,      "level": 3    },    {      "x": 960,      "y": 512,      "w": 576,      "h": 512,      "level": 3    }  ],  "candidates": [    {      "name": "Midjourney",      "score": 0.65    },    {      "name": "OpenAI",      "score": 0.25    }  ],  "quality": {    "overall": "fair",    "resolution": "good",    "compression": "fair",    "metadata": "fair",    "distribution": "good"  },  "limits": [    "no_metadata"  ],  "image": {    "width": 1536,    "height": 1024,    "format": "jpeg",    "jpeg_quality": 85  },  "usage": {    "credits": 4  }}
FieldTypeDescription
idstringDetection ID, prefixed idet_.
objectstringAlways image.detection.
createdintegerUnix timestamp.
modelstringSnapshot that produced the result.
livemodebooleanfalse for test keys.
verdictstringai_generated: the image was generated by AI. no_ai_signs: nothing points to AI generation. inconclusive: the evidence does not decide.
aiobjectThe answer on AI generation, with the same values as questions.ai in the image report.
generatorobject or nullThe generator the file declares through Content Credentials, metadata or a watermark, with name and basis. null when the file names none.
signalsarrayThe checks behind the answer, each with id and state. See Signals.
regionsarray or nullA coarse grid over the image. Each cell has x, y, w and h in pixels of the displayed image and a level from 0 to 3 for the strength of generation traits. null when the image is too small for a grid.
candidatesarrayUp to three generator families whose pixel traits the image most resembles, each with name and a score from 0 to 1. Empty unless the verdict is ai_generated.
qualityobject or nullHow well the file supports analysis: overall, resolution, compression, metadata and distribution, each good, fair or poor.
limitsarrayWhat limits the result: low_resolution, heavy_compression, platform_copy, no_metadata or models_disagree.
imageobjectwidth and height as displayed, format, and jpeg_quality, the estimated JPEG quality or null.
usageobjectcredits charged.

Reading the answer

`ai.key``verdict`Meaning
labelledai_generatedContent Credentials, an AI label or a watermark declare AI generation. ai.basis is verified for trusted credentials, otherwise declared or detected.
very_likely, suspectedai_generatedThe pixels indicate AI generation, strongly or with some disagreement.
undecidedinconclusiveThe signals are weak or contradict each other.
low, very_lowno_ai_signsNothing in the pixels or metadata points to AI generation.

ai.strength is strong, moderate or limited and says how strongly the evidence supports the answer. ai.likelihood runs from 0 to 100 in steps of 5, and is null for labelled.

no_ai_signs does not show that a photo is authentic or unedited. AI image detection does not look for edits. When a decision depends on it, run an image verification report and have a person review the result.

Signals

signals lists every check that ran, so you can see what the answer rests on. A state of ai points to AI generation.

`id``state`Check
model_1, model_2ai, unclear, clear, unavailableTwo independently trained models that analyse the pixels.
credentialsai, ai_unverified, other, noneContent Credentials (C2PA). ai_unverified: the credentials declare AI generation but their issuer could not be verified. other: credentials are present and declare no AI generation.
watermarkai, none, unavailableInvisible watermarks that open-source generation tools embed in the pixels.
labelai, noneA declaration of AI generation in the metadata, such as the IPTC digital source type.
tool_dataai, nonePrompts, parameters or generator names saved in the file.
camerapresent, noneCamera make, model and exposure data. It can be edited, and this endpoint does not verify it.

regions shows where generation traits are strongest. Cells at level 3 carry strong traits. When the verdict is no_ai_signs and some cells are at level 3, part of the image may have been generated or edited with AI: this endpoint does not examine local edits, so run an image verification report.

candidates is an indication, not an identification. It ranks generator families by how closely the pixel traits resemble them, and a generator outside the reference set appears as its nearest match. Rely on generator when the file itself names the tool.

Billing

  • AI image detection costs 4 credits per image.
  • An image verification report of the same image in the same workspace within 7 days costs 36 credits instead of 40: the detection's credits count toward it once. The analysis reports the charge in usage.credits.
  • Requests rejected before evaluation are not charged: invalid parameters, unsupported or damaged files, size limits and similar. A check that fails inside the service (service_unavailable, analysis_failed) is released and not charged.
  • Not enough credits return insufficient_balance (402).

What is stored

The image is examined and deleted. Fileverity keeps the result without the image (verdict, answer, generator, signals, regions, candidates, quality, dimensions, the file's SHA-256 fingerprint and usage) for 7 days, so the Console can show it and usage can be billed and audited. A retried request with the same Idempotency-Key gets the saved result for 24 hours. Image detections are synchronous: they do not appear in GET /analyses and do not send webhook events. Test keys record nothing. See Data retention and security.

Errors

CodeStatusCause
missing_parameter400The file field is missing.
invalid_parameter400A field has the wrong type, an unknown field was sent, the model is not an image detection model, or the Idempotency-Key is invalid.
file_not_found400The file ID is unknown, expired or already used.
unsupported_file, invalid_file415, 422The file is not a JPEG, PNG or WebP image, or it is damaged.
file_too_large, too_many_pixels413The multipart file exceeds 4 MB, the uploaded file exceeds 10 MB, or the image exceeds 40 megapixels.
unsupported_media_type, invalid_json415, 400The body is neither multipart/form-data nor a JSON object.
model_not_found404The model is unknown.
insufficient_balance, spend_limit_reached402The balance or the key's monthly limit cannot cover the request.
idempotency_mismatch, idempotency_in_progress409The Idempotency-Key was used with a different body, or its first request is still running.
service_unavailable, analysis_failed503, 502The detection service is temporarily unavailable or busy. Not charged; retry. service_unavailable carries a retry-after header.

Send an Idempotency-Key so that retrying after a timeout does not bill twice. See Idempotency.