Generate speech fingerprint
Generate a speaker fingerprint embedding from an uploaded audio file.
This endpoint requires authentication. Include your API key in the Authorization header. The
response returns a numeric embedding vector and its dimension.
Request Body (multipart/form-data)
| Parameter | Type | Required | Description |
|---|---|---|---|
file | binary | Yes | Audio file (WAV, MP3, OGG, FLAC, WebM) |
model | valsea-fingerprint | Yes | Valsea fingerprint model id |
Code Examples
curl -X POST https://api.valsea.ai/v1/fingerprint \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "model=valsea-fingerprint" \
-F "file=@audio.wav"
Response (200)
| Field | Type | Description |
|---|---|---|
object | string | Always fingerprint |
fingerprint | number[] | Numeric embedding vector |
dimension | integer | Embedding vector length |
Errors
| Status | Description |
|---|---|
400 | Invalid request/body |
401 | Missing or invalid API key |
402 | Insufficient credits |
413 | File too large |
500 | Internal server error |