---
title: "Clone a Voice"
method: POST
path: "/v3/voices/clone"
tags: ["Voices"]
---

# Clone a Voice

`POST /v3/voices/clone`

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.

## Request body

- CreateVoiceCloneV3Request — Request body for POST /v3/voices/clone.
  - `audio` union, required — Audio file for voice cloning. Provide as {type: 'url', url: '...'}, {type: 'asset_id', asset_id: '...'}, or {type: 'base64', media_type: '...', data: '...'}.
    - AssetUrl — Asset input via publicly accessible HTTPS URL.
      - `type` 'url', required — Input type discriminator
      - `url` string, required — Publicly accessible HTTPS URL for the asset
    - AssetId — Asset input via HeyGen asset ID from the asset upload endpoint.
      - `type` 'asset_id', required — Input type discriminator
      - `asset_id` string, required — HeyGen asset ID from the asset upload endpoint
    - AssetBase64 — Asset input via base64-encoded content.
      - `type` 'base64', required — Input type discriminator
      - `media_type` string, required — MIME type of the encoded content (e.g. "image/png")
      - `data` string, required — Base64-encoded file content
  - `voice_name` string, required — Display name for the cloned voice.
  - `language` string, nullable — Language hint for the voice (e.g., 'en', 'es'). Auto-detected if omitted.
  - `remove_background_noise` boolean — Remove background noise from the audio before cloning.

## Response `200`

Successful response

- object
  - `data` VoiceCloneCreateV3Response — Response for POST /v3/voices/clone.
    - `voice_clone_id` string, required — Voice clone ID. Use GET /v3/voices/{voice_clone_id} to poll status.

## Other responses

- `400` — Invalid request parameters
- `401` — Authentication failed
- `403` — Forbidden
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/heygen/apis/heygen-external-api.md) · [All operations](https://skmtc.net/heygen/apis/heygen-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/heygen/heygen-external-api/versions/e2e54726e210/schema)