You can classify a speech 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 a speech, you need to make a POST request to /api/classification_audio 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_audio \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-Api-Key: <api-key>' \
  --form "audio=@/path/to/sample.mp3"

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

You can also classify a speech from URL!

​
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_audio/{hash} \
  --header 'X-Api-Key: <api-key>'

The response will contain the classification results for the speech 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.

The classification may not be finished yet! If the classification is not yet complete, continue sending the GET request until the result is available.

​
See also

Classify an image

Find out how to start an image classification and discover whether your image is authentic or artificially generated

Classify a video

Find out how to start a video classification and discover whether your video is authentic or artificially generated