Generate Voice Candidates

POST https://app.resemble.ai/api/v2/voice-design

Generate voice candidates based on a text prompt describing desired voice characteristics.

Field	Type	Required	Notes
`user_prompt`	string	✅	Description of desired voice (e.g., “A warm, friendly female voice with a British accent”).
`is_voice_design_trial`	boolean	❌	Whether this is a trial generation. Default: true.

$ curl --request POST 'https://app.resemble.ai/api/v2/voice-design' \
>   -H 'Authorization: Bearer YOUR_API_TOKEN' \
>   -H 'Content-Type: application/json' \
>   --data '{
>     "user_prompt": "A warm, friendly female voice with a British accent",
>     "is_voice_design_trial": true
>   }'

1 {
2   "voice_candidates": {
3     "voice_design_model_uuid": "VOICE_DESIGN_UUID",
4     "samples": [
5       {
6         "audio_url": "https://...",
7         "sample_index": 0
8       },
9       {
10         "audio_url": "https://...",
11         "sample_index": 1
12       },
13       {
14         "audio_url": "https://...",
15         "sample_index": 2
16       }
17     ]
18   }
19 }

Free users are limited to one trial. Processing is synchronous. Returns multiple voice samples to choose from. Audio URLs expire in 4 hours.

$	curl --request POST 'https://app.resemble.ai/api/v2/voice-design' \
>	-H 'Authorization: Bearer YOUR_API_TOKEN' \
>	-H 'Content-Type: application/json' \
>	--data '{
>	"user_prompt": "A warm, friendly female voice with a British accent",
>	"is_voice_design_trial": true
>	}'

1	{
2	"voice_candidates": {
3	"voice_design_model_uuid": "VOICE_DESIGN_UUID",
4	"samples": [
5	{
6	"audio_url": "https://...",
7	"sample_index": 0
8	},
9	{
10	"audio_url": "https://...",
11	"sample_index": 1
12	},
13	{
14	"audio_url": "https://...",
15	"sample_index": 2
16	}
17	]
18	}
19	}