---
title: "Create Instant Clone"
method: POST
path: "/v1/custom-voices/instant-clone"
tags: ["Custom Voices"]
---

# Create Instant Clone

`POST /v1/custom-voices/instant-clone`

## Request

- Base URL: `https://api.typecast.ai`
- URL: `https://api.typecast.ai/v1/custom-voices/instant-clone`
- Auth: API key in header `X-API-KEY`

Creates a synthesis-ready custom voice from one WAV or MP3 recording. Send the audio, a display name, and a supported TTS model as `multipart/form-data`.

**Audio requirements**
- One WAV or MP3 file
- File size: 25 MiB or less
- Duration: 5 to 150 seconds

The request uses one custom voice slot. A successful response returns the completed voice immediately. Supported models may vary by account and release availability.

## Response `201`

Instant clone created successfully

- CustomVoiceCreateResponse: Result returned after creating an instant or professional custom voice.
  - `name` string, required: Voice name.
  - `model` string, required: TTS model version.
  - `status` 'pending' | 'training' | 'completed' | 'failed', required: Current creation or training status of a custom voice.
  - `voice_id` string, required: Unique custom voice identifier with the `uc_` prefix.

## Other responses

- `401`: Authentication failed
- `403`: Custom voice creation is unavailable or no custom voice slot remains
- `413`: The uploaded audio exceeds the configured size limit
- `422`: The form, audio format, or selected model is not supported
- `503`: The cloning service is temporarily at capacity

---

[API](https://skmtc.dev/typecast/apis/typecast-api.md) · [All operations](https://skmtc.dev/typecast/apis/typecast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/typecast/apis/typecast-api/revisions/41605154de82?raw)