POST
/
v1
/
voiceprint

This endpoint allows you to create a new voiceprint from a remote audio URL.

The audio file must contain only 1 person speaking.

The voiceprint can then be used to create a diarization with speaker identification, see Create Identification.

Voiceprint 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 voiceprint (Webhook)

The webhook URL is where the finished voiceprint 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

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