---
title: "Extract voiceprint"
method: POST
path: "/v1/voiceprint"
tags: ["Api", "Operations"]
---

# Extract voiceprint

`POST /v1/voiceprint`

## Request body

- VoiceprintRequest
  - `url` string, required — URL of the voiceprint audio file
  - `model` 'precision-2', nullable
  - `webhook` string — Webhook URL to receive voiceprint results (optional)
  - `webhookStatusOnly` boolean — When true, webhook payload only includes jobId and status (excludes output). Useful for large payloads.

## Response `200`

- JobCreated
  - `jobId` string, required — ID of the job
  - `status` 'pending' | 'created' | 'succeeded' | 'canceled' | 'failed' | 'running', required — Status of the job
  - `warning` string — Warning message if any

## Other responses

- `400` — Invalid request
- `402` — Subscription is required
- `429` — Too many requests

---

[API](https://skmtc.dev/pyannote/apis/pyannoteai-api.md) · [All operations](https://skmtc.dev/pyannote/apis/pyannoteai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pyannote/pyannoteai-api/revisions/9d61c3f2d6bb/schema)