Clone a voice from a recording

The recording is checked (at least 10s of speech, at least 40% of it speech, not too noisy or clipped); the best 10–30s stretch becomes the reference clip and is transcribed. On success a voice (tts_presets row) is created for the account. Asynchronous — 202 with an id; poll GET /voices/clones/{cloneId}. Requires consent.attested = true. Disabled unless the deployment enables voice cloning (403 feature_disabled).

Authorization

bearerAuth

AuthorizationBearer <token>

Typecut API key. Generate one in app.typecut.ai → Settings → API keys. Send as Authorization: Bearer tc_live_….

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

media_id?|

A library audio/video asset to clone from. Exactly one of media_id / upload_url.

Formatuuid

upload_url?|

An http(s) url to import into the library first, then clone from.

Formaturi

name*string

What the voice is called in pickers.

Length1 <= length <= 80

language?|

Language of the recording ('en', 'fr-fr'). Omit to use the language detected from the audio. A clone speaks with the accent of its reference.

consent*

REQUIRED, attested must be true: the person in the recording has agreed to their voice being cloned (or it is your own voice).

model?|

What the clone is made on: 'fish' (default — Fish S2.1 Pro, premium) or 'chatterbox' (Resemble Chatterbox on Replicate — standard tier; Turbo for English, Multilingual otherwise).

Value in"fish" | "chatterbox"

Response Body

`application/json`

curl -X POST "https://example.com/voices/clones" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "consent": {      "attested": true    }  }'

{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "status": "processing",
    "note": "string"
  }
}

{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}

{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}

{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}

{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}

{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}

Clone a voice from a recording

Authorization

Request Body

Response Body

202application/json

400application/json

401application/json

403application/json

404application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`