Skip to main content
POST
/
v1
/
me
/
voices
Create new voice
curl --request POST \
  --url https://api.voicedub.ai/v1/me/voices \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "My Custom Voice",
  "numberOfFiles": 3,
  "maxMinutes": 10,
  "separate": true
}
'
{
  "voice": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "My Custom Voice",
    "status": "new",
    "separate": true,
    "maxMinutes": 10,
    "errorCode": null,
    "errorMessage": null,
    "apiCreditsUsed": 0,
    "apiCreditsLeft": null,
    "completedAt": null,
    "createdAt": "2024-01-15T10:00:00.000Z",
    "updatedAt": "2024-01-15T10:30:00.000Z",
    "requiredCredits": 100
  },
  "uploadUrls": [
    "https://s3.amazonaws.com/bucket/models/123e4567-e89b-12d3-a456-426614174000/vocals/123e4567-e89b-12d3-a456-426614174000_0?X-Amz-Signature=...",
    "https://s3.amazonaws.com/bucket/models/123e4567-e89b-12d3-a456-426614174000/vocals/123e4567-e89b-12d3-a456-426614174000_1?X-Amz-Signature=..."
  ]
}

Authorizations

​
Authorization
string
header
required

API key in the format: "Api-Key "

Body

application/json
​
name
string
required

Display name for the voice (1-50 characters)

Required string length: 1 - 50
Example:

"My Custom Voice"

​
numberOfFiles
integer
required

Number of audio files to upload for training (1-5)

Required range: 1 <= x <= 5
Example:

3

​
maxMinutes
integer
default:10

Maximum duration of training audio in minutes (5-60)

Required range: 5 <= x <= 60
Example:

10

​
separate
boolean
default:true

Whether to use vocal separation during training

Example:

true

Response

200 - application/json

Voice created successfully

​
voice
object
required
​
uploadUrls
string<uri>[]
required

Presigned URLs for uploading training audio files

Example:
[
  "https://s3.amazonaws.com/bucket/models/123e4567-e89b-12d3-a456-426614174000/vocals/123e4567-e89b-12d3-a456-426614174000_0?X-Amz-Signature=...",
  "https://s3.amazonaws.com/bucket/models/123e4567-e89b-12d3-a456-426614174000/vocals/123e4567-e89b-12d3-a456-426614174000_1?X-Amz-Signature=..."
]