Skip to main content
POST
/
api
/
classification
Classify an image
curl --request POST \
  --url https://backend.identifai.net/api/classification \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-Api-Key: <api-key>' \
  --form with_morphing=true \
  --form with_tampering=true \
  --form with_heatmap=true \
  --form image=@example-file \
  --form webhook_url=https://example-webhook.com
{
  "identifier": "8d64370a87b820cc1cf620338f5c898bab37439c9a405f32d9eaffc50c4f27b0"
}

Authorizations

​
X-Api-Key
string
header
required

Your API key.

Body

multipart/form-data
​
image
file
required

The image to be classified.

​
with_morphing
boolean

Set it to true if you also want to analyze people's faces in the image using morphing.

​
with_tampering
boolean

Set it to true if you also want to analyze signs of tampering or manipulation without the aid of a Generative AI

​
with_heatmap
boolean

Set it to true if you also want to get an AI content heatmap.

​
webhook_url
string

If specified, the classification result will also be automatically sent to the entered URL. Otherwise, the result can be obtained by polling the relative endpoint. Please note that in order to use a webhook callback URL you need to request a specific enablement, otherwise the parameter is ignored. Moreover, the system may cache the analysis results of repeated submissions, i.e. submissions of the same file with the same options: in this case the webhook won't be called and the results would be accessible only by polling the relative endpoint.

Response

The classification identifier. The format depends on the Accept header.

​
identifier
string
Example:

"8d64370a87b820cc1cf620338f5c898bab37439c9a405f32d9eaffc50c4f27b0"