Recordings

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.

ParameterTypeRequiredNotes
voice_uuidstring✅Voice UUID (URL parameter).
FieldTypeRequiredNotes
filefile✅Audio file (must be between configured duration bounds).
namestring✅Recording name (max 256 characters, must be unique for this voice).
textstring✅Transcript of the audio (max 1024 characters).
emotionstring❌Emotion label (max 64 characters).
is_activeboolean❌Whether recording is active for training. Default: true.
fillboolean❌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.