Create an RVC vocal conversion
create_voice_conversionUse this when the user has selected a private voice model and wants to convert one vocal recording. Returns a private upload instruction. Upload only the source vocal, then call get_voice_conversion with the same conversion ID. Creating it counts one of the account's conversions (three free per account, each up to five minutes long; it comes back if the conversion fails); listening and downloads are free.
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": {
"modelId": "<modelId>",
"fileName": "<fileName>",
"durationSeconds": "<durationSeconds>"
},
"name": "create_voice_conversion"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| modelId | Yes | A voice id from list_voice_models: one of the user's models, or a licensed library voice (ids starting house_). | |
| fileName | Yes | Original WAV, MP3, FLAC, M4A, or OGG vocal filename. | |
| sizeBytes | No | Exact byte size of the source audio. Supply it whenever the client can measure the file so interrupted uploads are verifiable and safely resumable. | |
| transpose | No | Pitch shift in semitones, from -24 through 24. Use 0 when no shift was requested. | |
| wholeSong | No | true for a finished song with music (for example a Suno track): NiceVois separates it, converts the lead with this voice, keeps the instrumental and backing vocals, and returns the finished cover plus each stem. Leave out for an isolated vocal. | |
| durationSeconds | Yes | Measured duration of the source audio in seconds. NiceVois uses this to verify that the account can download the result before cloud work. | |
| acceptsVoiceLibraryTerms | No | Only after VOICE_LIBRARY_TERMS_REQUIRED, once the user has accepted the linked Voice Library Terms. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| error | No | ||
| stage | No | ||
| status | Yes | ||
| upload | Yes | ||
| outputs | Yes | ||
| timings | No | ||
| fileName | No | ||
| createdAt | No | ||
| modelName | No | ||
| transpose | No | ||
| restoration | No | ||
| stageMessage | No | ||
| providerState | No |