POST
/
v1
/
identify

This endpoint allows you to create a new diarization with speaker identification from a remote audio URL.

​
Identification of a Remote File (from url)

If you have a media file accessible via a URL, you can provide the URL to the file in the request body with the header Content-Type set to application/json.

Typically you would use this method if you have a file stored in a cloud storage service such as Amazon S3.

Make sure the URL to the file is publicly accessible, otherwise our endpoint cannot read the file

​
Receiving the identification segments (Webhook)

The webhook URL is where the finished identification segments will be sent. The voiceprint will be sent as a JSON object in the request body.

Make sure the webhook URL is publicly accessible, otherwise our server cannot send the output

Please visit the Webhook documentation for more information on what the webhook sends.

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
url
string
required

URL of the audio file, must be publicly accessible

voiceprints
object[]
required

List of voiceprints to identify. Each voiceprint must have a unique label. Maximum 10 voiceprints. Minimum 1 voiceprint.

webhook
string
required

URL to send the result to

Response

200 - application/json
jobId
string

Job ID to track the progress of the diarization

message
string

Message about the job

status
string

Status of the job

Create VoiceprintSegment Object