## Clone a Voice

### cURL

```bash
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
}
'
```

### Responses

#### 200

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

#### 400

#### 401

#### 403

#### 429

## Authorizations

### x-api-key

- **Type:** string  
- **Location:** header  
- **Required:** Yes

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.

- **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

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