PYpyannote
Api
Operations

Extract voiceprint

Changed on
post/v1/voiceprint

Request

  • Base URL
    https://api.pyannote.ai
  • URL
    https://api.pyannote.ai/v1/voiceprint
  • Auth
    HTTP bearer

Request body

urlstring required

URL of the voiceprint audio file

model'precision-2' | 'precision-3' nullable
webhookstring

Webhook URL to receive voiceprint results (optional)

webhookStatusOnlyboolean

When true, webhook payload only includes jobId and status (excludes output). Useful for large payloads.

Example request

{
  "url": "https://example.com/voice.wav",
  "model": "precision-2",
  "webhook": "https://example.com/webhook",
  "webhookStatusOnly": true
}

Response

jobIdstring required

ID of the job

status'pending' | 'created' | 'succeeded' | 'canceled' | 'failed' | 'running' required

Status of the job

warningstring

Warning message if any

Example response

{
  "jobId": "3c8a89a5-dcc6-4edb-a75d-ffd64739674d",
  "status": "created"
}

Changes