Skip to main content
POST
/
v1
/
voices
/
samples
Add Voice Sample
curl --request POST \
  --url https://api.bland.ai/v1/voices/samples \
  --header 'Content-Type: multipart/form-data' \
  --header 'authorization: <authorization>' \
  --form 'voice_id=<string>' \
  --form audio_samples.items='@example-file'
{
  "status": "success",
  "samples": [
    {
      "id": "d15b199a-1b79-4664-9a9a-b149ee3b136a",
      "voice_id": "73d4c04b-1e15-4272-9c7f-8d2955914ba9",
      "transcription": null,
      "duration_seconds": 11.4,
      "created_at": "2026-06-22T21:34:31.347Z"
    }
  ]
}

​
Overview

Appends one or more audio samples to an existing voice clone, retraining the voice on the expanded sample set. Sample limits depend on the voice’s engine. BTTS V1 voices accept up to 5 samples total. BTTS V2 and BTTS V3 voices are single-sample by design and do not accept additional samples; use Clone Voice to create a new voice instead. Sent as multipart/form-data.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Form Fields

​
voice_id
string
required
UUID of the voice to add samples to. Must be a voice your org owns.
​
audio_samples
file[]
required
WAV files to append. Each file 1-60 seconds, max 10 MB. The combined sample count after this call cannot exceed 5 for a V1 voice.

​
Response

​
status
string
success on success.
​
samples
array
The samples currently attached to the voice after the update. See List Voice Samples for field shape.
{
  "status": "success",
  "samples": [
    {
      "id": "d15b199a-1b79-4664-9a9a-b149ee3b136a",
      "voice_id": "73d4c04b-1e15-4272-9c7f-8d2955914ba9",
      "transcription": null,
      "duration_seconds": 11.4,
      "created_at": "2026-06-22T21:34:31.347Z"
    }
  ]
}
Docs for agents: llms.txt