Classify an image

You can classify an image either from a file or a URL.
This section explains how to make a request using a file. For a URL, the process is similar, with the main difference being the endpoint to call in step 1.

​

1. Send a POST request

To classify an image, you need to make a POST request to /api/classification with the required parameters (for details on the parameters, refer to the API Reference section).

curl --request POST \
  --url https://backend.identifai.net/api/classification \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-Api-Key: <api-key>' \
  --form "image=@/path/to/sample.jpg" \
  --form with_llm=false \
  --form with_morphing=false

In response you will receive the hash of the classified image.

​

2. Retrieve the results

Use the provided hash to retrieve the classification results by making a GET request to /api/classification/{hash} (for details on how to structure this request, see the API Reference section).

curl --request GET \
  --url https://backend.identifai.net/api/classification/{hash} \
  --header 'X-Api-Key: <api-key>'

The response will contain the classification results for the image in JSON format. In the response, you will find a results array, which includes the classification results for each model used, and a verdicts array, which contains the results for each heuristic applied.

​

See also