POST
/
create-custom-voice
curl --request POST \
  --url https://client.camb.ai/apis/create-custom-voice \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form 'voice_name=<string>' \
  --form gender=0 \
  --form description=null \
  --form publish_voice_to_market_place=null \
  --form age=30 \
  --form enhance_audio=false \
  --form language=null
{
  "voice_id": 123
}
The audio file should clearly represent the desired voice for optimal cloning accuracy.

This endpoint enables users to generate a custom cloned voice based on a provided sample, which is processed to replicate the unique characteristics of the reference voice. The resulting cloned voice can be used for various tasks such as text-to-speech, dubbing, and more.

​
Supported Files

The file property accepts the following file formats:

  • AAC
  • FLAC
  • MP3
  • WAV

​
Python Example

import requests

files = {'file': open('file.mp3', 'rb')}
data = {
    'voice_name': 'Voice Name',
    'gender': 1,
    'age': 30
}
response = requests.post(
    "https://client.camb.ai/apis/create-custom-voice",
    files=files,
    data=data,
    headers={
        "x-api-key": API_KEY
    }
)
print(response.json())

Authorizations

​
x-api-key
string
header
required

The x-api-key is a custom header required for authenticating requests to our API. Include this header in your request with the appropriate API key value to securely access our endpoints. You can find your API key(s) in the 'API' section of our studio website.

Body

multipart/form-data
​
voice_name
string
required

The name or label to be assigned to the voice.

​
gender
enum<integer>
required

Represents the gender of the speaker in the provided audio. Values are encoded as integers.

Available options:
0,
1,
2,
9
​
file
file
required

The reference audio file that will be used to create the custom voice. The file should have clear speech to ensure optimal cloning accuracy. Supported formats include .aac, .flac, .mp3 and .wav.

​
description
string | null

A brief summary of the custom voice—e.g. its intended use, tone or character traits.

​
publish_voice_to_market_place
boolean | null

Set this to true to publish this custom voice to the marketplace for others to use. By making it available in the marketplace you consent to the guidelines and terms & conditions.

​
age
integer
default:30

The estimated or actual age of the speaker in the reference audio.

Required range: x >= 1
​
enhance_audio
boolean
default:false

If set to true, the system will apply audio enhancement techniques such as noise reduction and volume normalization to improve voice clarity.

​
language
enum<integer>

The language of the reference audio file. This field is optional.

Available options:
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26,
27,
28,
29,
30,
31,
32,
33,
34,
35,
36,
37,
38,
39,
40,
41,
42,
43,
44,
45,
46,
47,
48,
49,
50,
51,
52,
53,
54,
55,
56,
57,
58,
59,
60,
61,
62,
63,
64,
65,
66,
67,
68,
69,
70,
71,
72,
73,
74,
75,
76,
77,
78,
79,
80,
81,
82,
83,
84,
85,
86,
87,
88,
89,
90,
91,
92,
93,
94,
95,
96,
97,
98,
99,
100,
101,
102,
103,
104,
105,
106,
107,
108,
109,
110,
111,
112,
113,
114,
115,
116,
117,
118,
119,
120,
121,
122,
123,
124,
125,
126,
127,
128,
129,
130,
131,
132,
133,
134,
135,
136,
137,
138,
139,
140,
141,
142,
143,
144,
145,
146,
147,
148

Response

200
application/json
Successful Response
​
voice_id
integer