Voices

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

post/v3/voices/clone

Request

  • Base URL
    https://api.heygen.com
  • URL
    https://api.heygen.com/v3/voices/clone
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

Request body

voice_namestring required

Display name for the cloned voice. Up to 100 characters; names longer than 64 characters are stored truncated to 64.

languagestring nullable

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

remove_background_noiseboolean

Remove background noise from the audio before cloning.

Response

Successful response

Changes

    • info

      added asset_id base64 url discriminator mapping keys to the request property

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status