Personalizing Your Voice
Voice Personalization Options
You can shape the character of your generated voice by specifying these key attributes:- Gender: Select the voice gender with a simple numeric code:
- Age: Add in the voice age to reflect the intended audience or context.
Selecting Your Voice
Our platform offers two approaches to finding the perfect voice:-
Choose from our voice library: Browse our collection of ready-to-use voices through the
/list-voices
endpoint to find the perfect match for your project. -
Use your signature voice: Utilize the
/create-custom-voice
endpoint to clone an audio recording containing your signature voice.
Language Support
Our technology supports numerous languages and dialects for global reach. To see whatβs available:- Check the
/source-languages
or/target-languages
endpoints for a complete list of supported languages with their corresponding IDs.
How the Process Works
This endpoint uses an asynchronous workflow, which means your application can keep doing other things while the speech is being generated. Hereβs how it works, step-by-step:Submit Your Request
Receive Your `task_id`
task_id
. This lets you check back later to see how things are goingβjust like tracking a package.Track Progress of Your Speech Generation
task_id
to check the current status of your request by calling the /tts/{task_id}
endpoint. Youβll know whether your audio is still being generated, completed, or if something went wrong.Retrieve the Final Audio File
SUCCESS
), youβll get a run_id
. Use this ID to download your final audio file from the /tts-result/{run_id}
endpoint.Example: Creating Your First Audio
Hereβs a practical example showing how to generate speech about Mars:Authorizations
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
The text to be converted to speech
The voice ID to be used to generate speech.
The language in which the provided text is written in.
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
, 73
, 74
, 75
, 76
, 78
, 79
, 80
, 81
, 82
, 83
, 84
, 85
, 86
, 87
, 88
, 90
, 91
, 92
, 93
, 94
, 95
, 96
, 97
, 98
, 99
, 100
, 101
, 102
, 103
, 104
, 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
, 139
, 140
, 141
, 142
, 143
, 144
, 145
, 146
, 148
The gender of the speaker.
0
, 1
, 2
, 9
The age of the speaker of in the speech to be generated.
Enter a distinctive name for your project that reflects its purpose or content. This name will be displayed in your CAMB.AI workspace dashboard and used to organize related assets, transcriptions, etc.. . Choose something memorable that helps you quickly identify this specific project among your other voice, audio and localization tasks.
3 - 255
Provide details about your project's goals and specifications. Include information such as the target languages for translation or dubbing, desired voice characteristics, emotional tones to capture, or specific audio processing requirements, outlining the workflow here can serve as valuable documentation for organizational purposes.
3 - 5000
Specify the organizational folder within your CAMB.AI workspace where this task should be created and stored. The folder must already exist in your workspace and be accessible through your current API key authentication. This helps maintain project organization by grouping related tasks together, making it easier to manage and locate your projects.
x >= 1
Response
Successful Response
A JSON that contains the unique identifier for the task. This is used to query the status of the story task that is running. It is returned when a create request is made for a text-to-speech.