Skip to main content
POST
Clone voice from sample audio (sync)

Authorizations

Authorization
string
header
required

Send your API Key in the Authorization header (Bearer <api_key>). See Authentication.

Headers

X-Idempotency-Key
string
required

Required on mutating POST requests that create tasks or change persisted data (max 64 characters). See Idempotency.

Maximum string length: 64

Body

application/json
voiceName
string
required

Display name for the cloned voice in your asset library

sampleText
string
required

Transcript of the reference audio (required)

provider
enum<string>

Clone engine (V1–V5). See Supported clone methods.

Available options:
V1,
V2,
V3,
V4,
V5
Example:

"V1"

refAudio
string

HTTPS reference audio URL (use refAudioMaterialId for uploaded files). Provide exactly one of the two.

sampleLanguage
string

Sample language locale (BCP-47). See Supported languages.

Example:

"zh-CN"

refAudioMaterialId
string

Material ID of an uploaded audio/video file

Response

200 - application/json

Success

code
integer
required

Business code; 200 means success

Example:

200

message
string

Human-readable detail when code is not success

Example:

""

data
object