save_voice

Save, rename or remove a voice

Save a provider's voice to the account by its id (provider + provider_voice_id, named by the provider unless you pass name), rename a saved one (voice_id + name), or take one off the shelf (voice_id + remove: true).

Scope

generation.write — Makes, edits, imports, shares and deletes media in the account.

Behaviour

Writes: Creates or changes items in the caller's own account.
Can delete or overwrite: Can delete, overwrite, cancel or withdraw something the caller already has, so a host should confirm it.
Reaches outside: Saving reads the voice's name and labels from its provider.
Idempotent: Calling it again with the same arguments has no further effect.

Inputs

providerstring · optional
one of "elevenlabs"
provider_voice_idstring · optional
at least 1 character · at most 120 characters
voice_idstring · optional
uuid
namestring · optional
at least 1 character · at most 80 characters
removetrue · optional

Example call

A tools/call request with the required arguments only, each a placeholder read off the schema. Replace them before sending.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "save_voice",
    "arguments": {}
  }
}

Input schema

As the server sends it in tools/list.

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "elevenlabs"
      ]
    },
    "provider_voice_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "voice_id": {
      "type": "string",
      "format": "uuid"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "remove": {
      "type": "boolean",
      "const": true
    }
  },
  "additionalProperties": false
}

Related tools

generate_image
Make an image in the user's Kuro account.
generate_clip
Start a short video clip generation.
animate_image
Animate an existing image or upload into a clip.
generate_voiceover
Start a voice-over generation from text.
generate_music
Start a music generation from a creative brief.
set_recipe_gallery
Put a ready generation made with a recipe on that recipe's public gallery — the examples a reader sees under the recipe — or take it off with `listed: fal…
quote_generation
Price a request exactly, and compare it to the balance, without creating anything.
set_brand_note
Replace the user's brand note (at most 2000 characters): who they are, what they sell, their tone, colours and words to avoid.

Every tool· This page as Markdown