curl -X POST 'https://api.elevenlabs.io/v1/voices/pvc/voice-id/samples' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -F 'files=@sample.bin' \
  -F 'remove_background_noise=false'

# POST /v1/voices/pvc/{voice_id}/samples (ElevenLabs API)
Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03

> Add Samples To Pvc Voice

## Critical Gotchas
* Authentication uses the non-standard `xi-api-key` header, not `Authorization: Bearer`. Sending a Bearer token returns HTTP 401.
* Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (`--output speech.mp3`) rather than parsing it.

## cURL
curl -X POST 'https://api.elevenlabs.io/v1/voices/pvc/voice-id/samples' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -F 'files=@sample.bin' \
  -F 'remove_background_noise=false'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| voice_id | path | string | Yes | Voice ID to be used, you can use https://api.elevenlabs.i... |
| files | body | string[] | Yes | Audio files used to create the voice. |
| remove_background_noise | body | boolean | No | If set will remove background noise for voice samples usi... |

## Response (200 OK)
[{"file_name":"sample.mp3","hash":"1234567890"}]

---
Need an API key? Get one at https://elevenlabs.io/app/sign-up

POST

/v1/voices/pvc/{voice_id}/samples

ElevenLabs API

Add Samples To Pvc Voice

Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03 · upstream hash matched

Actions

Agents: curl -H "Accept: text/markdown" this URL
→ 223 tokens · Vary: Accept

Critical gotchas

Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.

Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.

cURL

curl -X POST 'https://api.elevenlabs.io/v1/voices/pvc/voice-id/samples' \  -H "xi-api-key: $ELEVENLABS_API_KEY" \  -F 'files=@sample.bin' \  -F 'remove_background_noise=false'

Get a free ElevenLabs API key → sponsored

Parameters

Name	In	Type	Required	Description
voice_id	path	string	Yes	Voice ID to be used, you can use https://api.elevenlabs.io/v1/voices to list all the available voices.
files	body	string[]	Yes	Audio files used to create the voice.
remove_background_noise	body	boolean	No	If set will remove background noise for voice samples using our audio isolation model. If the samples do not include background noise, it can make the quality worse.

Response 200 OK

[
  {
    "file_name": "sample.mp3",
    "hash": "1234567890",
    "mime_type": "audio/mpeg",
    "sample_id": "DCwhRBWXzGAHq8TQ4Fs18",
    "size_bytes": 1000000
  }
]