Clippie AI logo
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 create scope.

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
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
  }'

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.

tools/call
{
  "name": "clone_voice",
  "arguments": {
    "fileId": "file_FROM_UPLOAD_FILE",
    "name": "Narrator",
    "consent": true
  }
}