Skip to main content
POST
Composite non-LLM image verification

Authorizations

Authorization
string
header
required

API key as Bearer token

Body

application/json
image
string
required

The image to verify, base64-encoded (max 15MB decoded). Processed transiently — never stored.

Maximum string length: 20971524
reference_image
string

Optional reference image (base64) for the face_match check. Without it, face_match is skipped even when requested.

Maximum string length: 20971524
checks
enum<string>[]

Subset of checks to run. Defaults to all of: face_match, age, forensic, synthetic.

Maximum array length: 4
Available options:
face_match,
age,
forensic,
synthetic
external_id
string

Your unique identifier (e.g. message ID, content ID) for correlating Tuteliq results with your own system. Echoed back in the response and included in webhook payloads so you can match alerts to the original content.

Maximum string length: 255
customer_id
string

Your end-customer identifier for multi-tenant / B2B2C scenarios. If you serve multiple customers (schools, apps, brands) from a single API key, set this to route webhook alerts to the correct customer. Echoed back in the response and included in webhook payloads as "customerId".

Maximum string length: 255
metadata
object

Arbitrary key-value pairs for additional context (e.g. { "channel": "discord", "region": "eu" }). Stored with the detection result, echoed in the response, and included in webhook payloads. Maximum 20 properties.

incident_moderation_enabled
boolean

Per-call override of your account incident logging setting. When set, it takes precedence for THIS request: true forces the incident to be persisted, false suppresses persistence. Omit to use your account default (which itself defaults to enabled). Useful to suppress logging for test traffic or to opt specific calls in or out.

Response

200 - application/json

Default Response

schema_version
string

Response schema version (currently "1.0")

checks_run
string[]

The checks that actually ran (face_match is excluded when no reference_image was provided)

face_match
object
age
object | null

Age estimate for the primary image, or null when no face was detected

forensic
object
synthetic
object
credits_used
number

Credits charged for this call

processing_ms
number

Total processing time in milliseconds

external_id
string

Echo of the external_id you provided in the request

customer_id
string

Echo of the customer_id you provided in the request

metadata
object

Echo of the metadata you provided in the request