Add samples to PVC voice - Threetone Documentation

Add samples to PVC voice

curl --request POST \
  --url https://api.threetone.in/v1/voices/pvc/{voice_id}/samples \
  --header 'Content-Type: multipart/form-data' \
  --form files=@example-file

import requests

url = "https://api.threetone.in/v1/voices/pvc/{voice_id}/samples"

files = { "files": ("example-file", open("example-file", "rb")) }

response = requests.post(url, files=files)

print(response.text)

const form = new FormData();
form.append('files', '<string>');

const options = {method: 'POST'};

options.body = form;

fetch('https://api.threetone.in/v1/voices/pvc/{voice_id}/samples', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

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

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

POST

/

v1

/

voices

/

pvc

/

{voice_id}

/

samples

Add samples to PVC voice

curl --request POST \
  --url https://api.threetone.in/v1/voices/pvc/{voice_id}/samples \
  --header 'Content-Type: multipart/form-data' \
  --form files=@example-file

import requests

url = "https://api.threetone.in/v1/voices/pvc/{voice_id}/samples"

files = { "files": ("example-file", open("example-file", "rb")) }

response = requests.post(url, files=files)

print(response.text)

const form = new FormData();
form.append('files', '<string>');

const options = {method: 'POST'};

options.body = form;

fetch('https://api.threetone.in/v1/voices/pvc/{voice_id}/samples', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

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

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Headers

x-api-key

string | null

Your API key for programmatic access. Send it in the x-api-key header; you can create and manage keys from the Developers page.

Path Parameters

voice_id

string

required

Voice ID to be used, you can use GET /v1/voices to list all the available voices.

Example:

"21m00Tcm4TlvDq8ikWAM"

Body

multipart/form-data

files

file[]

required

Audio files used to create the voice.

remove_background_noise

boolean

default:false

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.

Example:

true

Response

Successful Response

sample_id

string

required

The ID of the sample.

file_name

string

required

The name of the sample file.

mime_type

string

required

The MIME type of the sample file.

size_bytes

integer

required

The size of the sample file in bytes.

hash

string

required

The hash of the sample file.

duration_secs

number | null

remove_background_noise

boolean | null

has_isolated_audio

boolean | null

has_isolated_audio_preview

boolean | null

speaker_separation

SpeakerSeparationResponseModel · object | null

Show child attributes

Example:

{
  "sample_id": "DCwhRBWXzGAHq8TQ4Fs18",
  "status": "not_started",
  "voice_id": "DCwhRBWXzGAHq8TQ4Fs18"
}

trim_start

integer | null

trim_end

integer | null