Venice Voice Clone / List
venice_voice_cloneList available TTS voices or clone a voice from an audio sample URL, returning a vv_ handle for use with the matching text-to-speech model.
Instructions
Discover or clone TTS voices. Action 'list' reads live per-model voice metadata from auth-free GET /v1/models?type=tts. Action 'create' requires sample_url, then uploads the sample to POST /v1/audio/voices for the chosen cloning model. Cloned voices come back as a vv_<id> handle; pass it as venice_tts voice together with the same model. Supports x402 wallet auth (no Venice account needed) and API key.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "venice_voice_clone"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | TTS model the cloned voice is paired with (action=create). Defaults to tts-chatterbox-hd. | |
| action | Yes | list = fetch live TTS model voice metadata; create requires sample_url | |
| sample_url | No | Required for action=create. Audio sample as an http(s) URL or an inline base64 data URL; tts-chatterbox-hd accepts MP3/WAV/FLAC/M4A, tts-minimax-speech-02-hd MP3/WAV only. Include a concrete media type in data URLs, e.g. audio/mpeg for MP3 or audio/mp4 for M4A. |