メインコンテンツへスキップ
POST
/
voices
/
clone
Clone Voice
curl --request POST \
  --url https://api.cartesia.ai/voices/clone \
  --header 'Cartesia-Version: <cartesia-version>' \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-API-Key: <api-key>' \
  --form clip='@example-file' \
  --form 'name=<string>' \
  --form 'description=<string>' \
  --form 'base_voice_id=<string>' \
  --form enhance=true
{
  "id": "<string>",
  "user_id": "<string>",
  "is_public": true,
  "name": "<string>",
  "description": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "language": "en"
}

承認

​
X-API-Key
string
header
必須

ヘッダー

​
Cartesia-Version
enum<string>
必須

API version header.

利用可能なオプション:
2024-06-10
例:

"2024-06-10"

ボディ

multipart/form-data
​
clip
file
必須

See Clone Voices for guidance on choosing a clip.

Supported audio formats: flac, mp3, mpeg, mpga, oga, ogg, wav, webm

​
name
string
必須

The name of the voice.

​
language
enum<string>
必須

The language of the voice.

利用可能なオプション:
en,
fr,
de,
es,
pt,
zh,
ja,
hi,
it,
ko,
nl,
pl,
ru,
sv,
tr
​
description
string | null

A description for the voice.

​
base_voice_id
string | null

Optional base voice ID that the cloned voice is derived from.

​
mode
enum<string>
非推奨

No longer used

利用可能なオプション:
similarity,
stability
​
enhance
boolean | null
非推奨

Whether to apply AI enhancements to the clip to reduce background noise. This leads to cleaner generated speech at the cost of reduced similarity to the source clip.

レスポンス

200 - application/json
​
id
string
必須

The ID of the voice.

​
user_id
string
必須

The ID of the user who owns the voice.

​
is_public
boolean
必須

Whether the voice is publicly accessible.

​
name
string
必須

The name of the voice.

​
description
string
必須

The description of the voice.

​
created_at
string<date-time>
必須

The date and time the voice was created.

​
language
string
必須

The voice's language, as an ISO 639-1 code (e.g. en, fr, zh)

例:

"en"