Browse the docs
Developers / Docs / Resources
Clone voice
Clones a narrator voice from an audio sample and saves it to the user's voices. Upload the sample first with upload_file (1 to 3 minutes of one person speaking clearly, no music, MP3 or WAV under 10 MB) and pass its fileId. Before calling, ask the user to confirm this and pass consent: true only when they do: "I own this voice, or I have the speaker's permission to clone it. I won't use it to impersonate anyone or to mislead people." Spends no credits but uses one of the plan's custom voice slots. Returns a voice id for text_to_speech and every voiceId input. Clone once and reuse the id; do not clone the same voice again.
Paste it into any AI assistant. The shortcuts open with the prompt typed in; nothing is sent until you press enter.
At a glance
- REST
POST https://api.clippie.ai/v1/voices/clone
- MCP tool
clone_voice
- Scope
create
- Cost
- Spends nothing. Needs the
createscope.
- Spends nothing. Needs the
Parameters
fileId- In:
- body
- Type:
- string
- Required:
- Yes
- Description:
- file_… from upload_file: an audio file of the voice. 1-80 chars.
name- In:
- body
- Type:
- string
- Required:
- Yes
- Description:
- What to call the voice, e.g. "Narrator". 1-60 chars.
consent- In:
- body
- Type:
- boolean
- Required:
- Yes
- Description:
- True only after the user confirms: "I own this voice, or I have the speaker's permission to clone it. I won't use it to impersonate anyone or to mislead people."
removeBackgroundNoise- In:
- body
- Type:
- boolean
- Required:
- No
- Default:
false- Description:
- Clean up background noise in the sample first. Leave off for clean recordings.
idempotencyKey- In:
- body
- Type:
- string
- Required:
- No
- Description:
- Reuse it when retrying, so a retry returns the voice from the first call instead of cloning twice. 1-200 chars.
Example
curl https://api.clippie.ai/v1/voices/clone \
-H "Authorization: Bearer $CLIPPIE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"fileId": "file_FROM_UPLOAD_FILE",
"name": "Narrator",
"consent": true
}'const auth = { Authorization: `Bearer ${process.env.CLIPPIE_API_KEY}` };
const res = await fetch('https://api.clippie.ai/v1/voices/clone', {
method: 'POST',
headers: { ...auth, 'Content-Type': 'application/json' },
body: JSON.stringify({
"fileId": "file_FROM_UPLOAD_FILE",
"name": "Narrator",
"consent": true
}),
});
if (!res.ok) throw new Error((await res.json()).error.message);
console.log(await res.json());Response
200 with JSON. The full response schema is in the OpenAPI spec.
From an MCP client
Your AI calls clone_voice with the same fields as JSON arguments. See MCP server to connect one.
{
"name": "clone_voice",
"arguments": {
"fileId": "file_FROM_UPLOAD_FILE",
"name": "Narrator",
"consent": true
}
}