HomeTokenhotAPI Document
Tools
language
language
  • 中文
  • English
HomeTokenhotAPI Document
Tools
language
language
  • 中文
  • English
  1. MiMo
  • OpenAI-Compatible Format — Unified LLM API Documentation
  • Quick Start
  • Image Models
    • DOUBAO
      • doubao-seedream-4-0-250828
      • doubao-seedream-4-5-251128
      • doubao-seedream-5-0-260128
      • doubao-seedream-4-0-250828 (image editing)
      • doubao-seedream-4-5-251128 (Picture editing)
      • doubao-seedream-5-0-260128 (image editing)
    • GPT
      • GPT Image-1.5
      • GPT Image-1.5 (image editing)
      • GPT Image-2 (image editing)
      • GPT Image-2
      • gpt-image-2-text-to-image
      • gpt-image-2-image-to-image
    • Gemini
      • gemini-3-pro-image-preview
      • gemini-3-pro-image-preview (image editing)
      • gemini-2.5-flash-image
      • gemini-2.5-flash-image (image editing)
      • gemini-3.1-flash-image-preview
      • gemini-3.1-flash-image-preview (image editing)
      • nano-banana-pro
      • nano-banana-2
      • nano-banana-2-lite
    • Dall
      • dall-e-2
      • dall-e-3
    • Wan
      • wan2.6-image (image editing)
      • wan2.6-image
    • Qwen
      • qwen-image-edit-max-2026-01-16
      • qwen-image-max
      • qwen-image-plus-2026-01-09
  • Video Models
    • DOUBAO
      • doubao-seedance-2-0-260128
      • doubao-seedance-2.0 (Get video task information)
      • doubao-seedance-2.0-V2V (Get video task information)
      • doubao-seedance-2.0-fast (get video task information)
      • doubao-seedance-2.0-fast-V2V (Get video task information)
      • doubao-seedance-2.0
      • doubao-seedance-2.0-V2V
      • doubao-seedance-2.0-fast
      • doubao-seedance-2.0-fast-V2V
    • Sora
      • Sora-2
      • Sora-2 (Get Video Task Status)
      • Sora-2 (Get Video Content)
    • MiniMax
      • MiniMax-Hailuo-02
      • MiniMax-Hailuo-2.3
      • MiniMax-Hailuo-2.3-Fast
      • Hailuo Get Video Info
    • HappyHorse
      • happyhorse-1.0-t2v
      • HappyHorse Get Video Info
      • happyhorse-1.0-video-edit
      • happyhorse-1.0-r2v
      • happyhorse-1.0-i2v
    • Kling
      • kling-v3
        • Text-to-Video (kling-v3)
        • First/Last Frame Video Generation (kling-v3)
        • Subject-Controlled Video Generation (kling-v3)
      • kling-v3-omni
        • Text-to-Video (kling-v3-omni)
        • First/Last Frame Video Generation (kling-v3-omni)
        • Subject-Controlled Video Generation (kling-v3-omni)
      • Create Subject
      • Query Subject
      • Query Video Task
    • Grok
      • grok-imagine-video-1-5-preview
      • Query Video Task
    • Veo
      • veo3.1
      • veo3.1 Video Extension (extend)
      • Query Video Task
    • Gemini
      • Create Character (omni character)
      • Create Voice (omni audio)
      • gemini-omni-video
      • Query Video Task
  • Chat Models
    • Claude
      • claude-sonnet-4-5-20250929
      • claude-opus-4-6
      • claude-opus-4-6-cc
    • GPT
      • GPT 5
      • GPT 5(Responses)
      • GPT 5.2
      • GPT 5.2(Responses)
      • GPT 5.4
      • GPT 5.4(Responses)
    • Gemini
      • gemini-2.5-flash
      • gemini-2.5-pro
      • gemini-3-flash-preview
      • gemini-3.1-pro
      • gemini-3.1-pro-preview
      • gemini-3.1-pro-preview (streaming)
    • Grok
      • grok-4.1
  • Audio Models
    • Gemini
      • gemini-2.5-flash-preview-tts
      • gemini-2.5-pro-preview-tts
    • Whisper
      • whisper-1 (audio translation)
      • whisper-1 (Audio to Chinese)
    • MiMo
      • mimo-v2.5-tts (Preset Voice Speech Synthesis)
        POST
      • mimo-v2.5-tts-voiceclone (Voice Cloning Speech Synthesis)
        POST
      • mimo-v2.5-tts-voicedesign (Text-Designed Voice Speech Synthesis)
        POST
  • Serve
    • Privacy agreement
    • Terms of Service
  1. MiMo

mimo-v2.5-tts-voicedesign (Text-Designed Voice Speech Synthesis)

POST
https://api.tokenhot.ai/v1/chat/completions
Actual API Endpoint: POST https://api.tokenhot.ai/v1/chat/completions
Model Code: mimo-v2.5-tts-voicedesign
Design a custom voice through text description for speech synthesis. No audio file is required — simply describe the voice characteristics in the user message to generate customized speech.
The role: 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.
The role: assistant message contains the text to synthesize.
The optimize_text_preview parameter controls whether the broadcast text is intelligently polished; when set to true, the assistant message can be omitted.
Singing mode, preset voices, and voice cloning are not supported.
The low-latency streaming feature is not yet available; the streaming interface falls back to compatibility mode (returns all at once after inference completes).
Key Voice Description Dimensions (not all are required):
DimensionExamples
Gender & Ageyoung woman in her mid-20s, middle-aged man in his 50s
Timbre / Texturedeep and gravelly, smooth and rich with a magnetic quality
Emotion / Tonewarm and confident, gentle but with a hint of fatigue
Speed / Rhythmslow and deliberate, extremely fast like a machine gun
Character / Personanarrator, podcast host, storyteller, late-night radio DJ
Scene Descriptionnarrating a nature documentary, pitching to investors

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Body Params application/json

Examples

Responses

🟢200
application/json
Synthesis successful
Bodyapplication/json

🟠400
🟠401
🔴503
Request Request Example
Shell
JavaScript
Java
Swift
cURL
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
    }
}'
Response Response Example
200 - 成功示例
{
    "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"
        }
    ]
}
Modified at 2026-06-29 10:22:09
Previous
mimo-v2.5-tts-voiceclone (Voice Cloning Speech Synthesis)
Next
Privacy agreement
Built with