Skip to main content
Validate a media file

Authorizations

X-Api-Key
string
header
required

Your API key.

Body

multipart/form-data
type
enum<string>
required

The kind of media to validate. Video and audio validation require the same enablement of the corresponding classification endpoints.

Available options:
image,
video,
audio
file
file
required

The media file to validate. Supported formats and maximum size depend on type and are the same of the corresponding classification endpoint: image, video, audio.

with_morphing
boolean

Image and video only. Set it to true to validate the file also against the models used to analyze people's faces (morphing).

with_tampering
boolean

Image and video only. Set it to true to validate the file also against the models used to analyze signs of tampering or manipulation.

with_heatmap
boolean

Image only. Set it to true to validate the file also against the models used to produce the AI content heatmap.

with_nsfw
boolean

Image and video only. Set it to true to validate the file also against the models used for NSFW (Not Safe For Work) content detection.

with_audio
boolean

[BETA] Video only. Set it to true to validate the file also against the models used to analyze the audio track of the video. You must be enabled in your pricing plan to use it, otherwise the parameter is ignored.

Response

The media is valid and can be submitted for classification with the given options.

valid
boolean
required

Always true for a successful validation: the media can be submitted for classification with the given options.

filesize
integer
required

Size of the validated file, in bytes.

mimetype
string
required

MIME type detected from the file content (e.g. image/jpeg, video/mp4, audio/mpeg).

models
string[]
required

Identifiers of the models the media has been validated against, resolved from your pricing plan and the selected options.

width
integer | null

Width of the media in pixels. null for audio files.

height
integer | null

Height of the media in pixels. null for audio files.