Skip to main content
Classify a speech
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='@example-file' \
  --form 'ref_id=<string>' \
  --form 'webhook_url=<string>' \
  --form no_cache=true \
  --form prevent_c2pa_forces=true
{
  "identifier": "8d64370a87b820cc1cf620338f5c898bab37439c9a405f32d9eaffc50c4f27b0"
}

Authorizations

ā€‹
X-Api-Key
string
header
required

Your API key.

Headers

ā€‹
Accept
enum<string>

Response content type. Supported: application/json, text/plain.

Available options:
application/json,
text/plain

Body

multipart/form-data
ā€‹
audio
file
required

The speech to be classified. Supported formats: MP3, WAV, OGG, FLAC, AAC, 3GP, M4A, M4B, M4P, M4R, MP4. MIME types: audio/mpeg, audio/wav, audio/ogg, audio/flac, audio/aac, audio/3gp, audio/m4a, audio/m4b, audio/m4p, audio/m4r, video/mp4. Maximum file size: 50MB.

ā€‹
ref_id
string

An optional reference ID to associate with the classification request.

ā€‹
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.

ā€‹
no_cache
boolean

Set it to true to force the system to reprocess the image even if it has been previously submitted with the same options. This may result in additional charges.

ā€‹
prevent_c2pa_forces
boolean

If true, C2PA signature does not force the origin to artificial. If false or undefined, C2PA signature will force the origin to artificial (current behaviour).

Response

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

ā€‹
identifier
string
Example:

"8d64370a87b820cc1cf620338f5c898bab37439c9a405f32d9eaffc50c4f27b0"