In this guide you will learn how to perform an identity verification on an audio, against one of the voiceprints of an identity.

If you are unfamiliar with these concepts, follow their links or read the API reference introduction.

✦ Goal: perform an identity verification and obtain its score.

​
Prerequisites

1

Set up your HTTP client

Use the playground or automatically generate requests from the OpenAPI definition.

2

Authenticate using your credentials or API keys

Your API requests must be authenticated using your credentials or API keys.

3

Gain access to a space

You can only operate in spaces that belong to your user or to one of your organizations. Review these relationships if your access is denied.

---> owner space

4

Create an identity

You must have created an identity in the chosen space.

---> identity

5

Compute a voiceprint

You must have computed a voiceprint for the created identity.

---> voiceprint

6

Upload an audio

You must have uploaded an audio to the chosen space.

---> audio

​
Procedure

1

Perform the identity verification

Perform the identity verification on the uploaded audio with the chosen model, providing the target identity and its selected voiceprint. See the API reference.

<--- owner space audio identity voiceprint

Optionally, you may choose the alias for the verification.

In identity verifications, an appropriate model for the voiceprint is automatically selected.

In verifications, the latest model version is automatically selected.

---> ✦ verification model version ✦ score

In verifications, confidence in a positive result is represented by their scores. Learn more.

  • Method — POST
  • Path — /spaces/{owner}/{space}/verifications/identity
  • Body — application/json
{
  "audio": "{audio}",
  "identity": "{identity}",
  "voiceprint": "{voiceprint}"
}

​
Validation

1

Validate the identity verification details

To validate that the identity verification has been correctly performed, retrieve and analyze its details. See the API reference.

<--- owner space verification

  • Method — GET
  • Path — /spaces/{owner}/{space}/verifications/identity/{verification}
2

Validate the verification usage records

To validate that the identity verification has been correctly performed, retrieve and analyze the verification usage records. See the API reference.

<--- owner

This step assumes that the owner is an organization. If you are the owner, you must use a slightly different endpoint. See the API reference.

  • Method — GET
  • Path — /orgs/{owner}/records/verification

OverviewAuthenticity