POST https://api.tokenhot.ai/v1/chat/completionsmimo-v2.5-tts-voicedesignrole: user message is a required parameter containing the voice design description (voice design prompt). The more specific and vivid the description, the closer the generated voice will match your expectations.role: assistant message contains the text to synthesize.optimize_text_preview parameter controls whether the broadcast text is intelligently polished; when set to true, the assistant message can be omitted.| Dimension | Examples |
|---|---|
| Gender & Age | young woman in her mid-20s, middle-aged man in his 50s |
| Timbre / Texture | deep and gravelly, smooth and rich with a magnetic quality |
| Emotion / Tone | warm and confident, gentle but with a hint of fatigue |
| Speed / Rhythm | slow and deliberate, extremely fast like a machine gun |
| Character / Persona | narrator, podcast host, storyteller, late-night radio DJ |
| Scene Description | narrating a nature documentary, pitching to investors |
curl --location 'https://api.tokenhot.ai/v1/chat/completions' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "mimo-v2.5-tts-voicedesign",
"messages": [
{
"role": "user",
"content": "Give me a young male tone."
},
{
"role": "assistant",
"content": "Yes, I had a sandwich."
}
],
"audio": {
"format": "wav",
"optimize_text_preview": true
}
}'{
"id": "chatcmpl-abc123def456",
"object": "chat.completion",
"created": 1774324467,
"model": "mimo-v2.5-tts-voicedesign",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"audio": {
"id": "3864a4690d8a4aaea5f6acf4853a0600",
"data": "UklGR...(Base64-encoded audio data)",
"expires_at": null,
"transcript": null
}
},
"finish_reason": "stop"
}
]
}