Clone a Voice

Creates a voice clone from an audio file. Returns a voice_clone_id that can be polled via GET /v3/voices/ until the status is ‘complete’. The resulting voice can be used with POST /v3/voices/speech and POST /v3/videos.

POST /v3/voices/clone

Clone a Voice

cURL

curl --request POST \
  --url https://api.heygen.com/v3/voices/clone \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "audio": {
    "type": "<string>",
    "url": "<string>"
  },
  "voice_name": "<string>",
  "language": "<string>",
  "remove_background_noise": true
}
'

200

{
  "data": {
    "voice_clone_id": "<string>"
  }
}

Authorizations

ApiKeyAuthBearerAuth

x-api-key · string · header · required

HeyGen API key. Obtain from your HeyGen dashboard.

Body

application/json

Request body for POST /v3/voices/clone.

audio · AssetUrl · object · required

Asset input via publicly accessible HTTPS URL.

AssetUrl

AssetId

AssetBase64

Show child attributes

voice_name · string · required

Display name for the cloned voice.

Required string length: 1 - 100

language · string | null

Language hint for the voice (e.g., 'en', 'es'). Auto-detected if omitted.

remove_background_noise · boolean · default: true

Remove background noise from the audio before cloning.

Response

200

application/json

Successful response

data · VoiceCloneCreateV3Response · object

Response for POST /v3/voices/clone.

Show child attributes