Preview voice
preview_voicePlay ONE voice from find_voices' candidates — call once per candidate, up to three.
This tool does not search, and one call answers with one voice. Pass a candidate's
catalog_voice_id, repeat for the others so the user can compare, and let them say
which is theirs. language is a family (ko) or a locale (ko-kr).
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": {
"catalog_voice_id": "<catalog_voice_id>",
"language": "<language>"
},
"name": "preview_voice"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| language | Yes | A family (`ko`) or locale (`ko-kr`) — one of the voice's preview_locales from find_voices. | |
| catalog_voice_id | Yes | A catalog_voice_id exactly as find_voices returned it. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | ||
| locale | No | ||
| played | No | ||
| next_step | No | ||
| sample_url | No | ||
| voice_name | No | ||
| content_type | No | ||
| catalog_voice_id | No |