> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.youratlas.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.youratlas.com/_mcp/server.

# Clone voice

POST https://api.youratlas.com/v1/api/voices
Content-Type: multipart/form-data

Create a custom cloned voice from audio samples

Reference: https://docs.youratlas.com/api-reference/atlas-api/voices/clone-voice

## Authentication

- `api-key` header (required) — Your Atlas API key. Get it from the Atlas Portal under Settings > API Keys.

## Request

### Body (multipart/form-data)

This endpoint expects a multipart form with multiple files.

- `files` (files, required)
- `name` (string, required)
- `language` (string, required)
- `description` (string, optional)
- `gender` (enum, required)
- `provider` (enum, required)
- `removeBackgroundNoise` (boolean, optional)

## Response

### 200

Voice cloned

- `odata.etag` (string, optional)
- `PartitionKey` (string, optional)
- `RowKey` (string, optional)
- `Timestamp` (datetime, optional)
- `Name` (string, optional)
- `Description` (string, optional)
- `Gender` (string, optional)
- `Language` (string, optional)
- `Provider` (string, optional)
- `ProviderID` (string, optional)
- `PreviewUrl` (string, optional)
- `ProviderSettings` (string, optional) — JSON-encoded string, e.g. \{"Stability":0.5,"SimilarityBoost":0.75,"Model":"eleven\_monolingual\_v1"}

## Errors

### 400 Bad Request Error

Bad request

- `error` (ErrorError, optional)

### 500 Internal Server Error

Internal server error

- `error` (ErrorError, optional)

## Types

### ErrorError

- `message` (string, optional)
- `code` (string, optional)
- `requestId` (string, optional)