Create Recording

POST https://app.resemble.ai/api/v2/voices/{voice_uuid}/recordings

Upload a new recording for a voice. Must be multipart/form-data.

Parameter	Type	Required	Notes
`voice_uuid`	string	✅	Voice UUID (URL parameter).

Field	Type	Required	Notes
`file`	file	✅	Audio file (must be between configured duration bounds).
`name`	string	✅	Recording name (max 256 characters, must be unique for this voice).
`text`	string	✅	Transcript of the audio (max 1024 characters).
`emotion`	string	❌	Emotion label (max 64 characters).
`is_active`	boolean	❌	Whether recording is active for training. Default: true.
`fill`	boolean	❌	Whether to use for fill/speech-to-speech.

$ curl --request POST 'https://app.resemble.ai/api/v2/voices/VOICE_UUID/recordings' \
>   -H 'Authorization: Bearer YOUR_API_TOKEN' \
>   -F 'file=@/path/to/line.wav' \
>   -F 'name=intro_line' \
>   -F 'text=Welcome to our show' \
>   -F 'emotion=neutral' \
>   -F 'is_active=true'

1 {
2   "success": true,
3   "item": {
4     "uuid": "RECORDING_UUID",
5     "name": "intro_line",
6     "text": "Welcome to our show",
7     "emotion": "neutral",
8     "fill": false,
9     "is_active": true,
10     "audio_src": "https://...",
11     "created_at": "2024-01-15T10:30:00Z",
12     "updated_at": "2024-01-15T10:30:00Z"
13   }
14 }

Audio file must not be silent. Audio duration must be within configured bounds (typically 1-60 seconds). Cannot upload recordings to pre-built or marketplace voices.

$	curl --request POST 'https://app.resemble.ai/api/v2/voices/VOICE_UUID/recordings' \
>	-H 'Authorization: Bearer YOUR_API_TOKEN' \
>	-F 'file=@/path/to/line.wav' \
>	-F 'name=intro_line' \
>	-F 'text=Welcome to our show' \
>	-F 'emotion=neutral' \
>	-F 'is_active=true'

1	{
2	"success": true,
3	"item": {
4	"uuid": "RECORDING_UUID",
5	"name": "intro_line",
6	"text": "Welcome to our show",
7	"emotion": "neutral",
8	"fill": false,
9	"is_active": true,
10	"audio_src": "https://...",
11	"created_at": "2024-01-15T10:30:00Z",
12	"updated_at": "2024-01-15T10:30:00Z"
13	}
14	}