---
title: "Create cloned voice"
method: POST
path: "/v1/custom-voices/cloned-voice"
tags: ["custom_voices"]
---

# Create cloned voice

`POST /v1/custom-voices/cloned-voice`

## Request

- Base URL: `https://supertoneapi.com`
- URL: `https://supertoneapi.com/v1/custom-voices/cloned-voice`
- Auth: API key in header `x-sup-api-key`
- TypeScript: <https://skmtc.dev/supertoneapi/apis/supertone-public-api/docs/v1/custom-voices/cloned-voice/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a custom (cloned) voice from uploaded audio files.

## Request body `multipart/form-data`

- object
  - `files` string, binary, required: Audio file to clone voice from (all common audio formats accepted, max 3MB)
  - `name` string, required: Name of the cloned voice
  - `description` string: Description of the cloned voice

## Response `200`

Successfully created cloned voice

- CreateCustomVoiceResponse
  - `voice_id` string, required: Unique identifier for the created voice

## Other responses

- `400`: Bad Request: Invalid file or request data
- `401`: Unauthorized: Invalid API key
- `403`: Forbidden: Insufficient tier access (STARTER tier or higher required)
- `404`: Not Found: No custom voices found
- `413`: Payload Too Large: File size exceeds 3MB limit
- `415`: Unsupported Media Type: Invalid audio file format
- `429`: Rate Limit Exceeded: Too many requests (10 per 60 seconds)
- `500`: Internal Server Error: Failed to get custom voices

---

[API](https://skmtc.dev/supertoneapi/apis/supertone-public-api.md) - [All operations](https://skmtc.dev/supertoneapi/apis/supertone-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/supertoneapi/apis/supertone-public-api/revisions/1ac6d0957e70?raw)