MiniMax 音乐/语音/声音克隆(4 合 1)
Music, speech, and a voice clone in one node
- reference_audio
- api_config
- audio
- audio_url
- audio_path
- result_text
- task_id
- response
MiniMax is one of the bigger Chinese AI labs, and its audio side covers three genuinely different jobs - music generation, speech synthesis (HD and Turbo tiers), and voice cloning - plus this node's fourth trick: it hands you all three behind a single model dropdown, and the UI hides whatever doesn't apply. One node, four jobs, no audio-engineering degree required. It's the most flexible audio node in the T8mars/ComfyUI_Seedance pack, and the one you'll want if your workflow touches both music and voice.
As ever with this pack: API wrapper, key from api.seedance.nz, requests only, nothing runs locally.
How it works
The model choice selects the path, and the required inputs change meaning accordingly:
- Music -
promptdescribes the style;lyricstakes lyrics with optional structure tags.is_instrumentalmakes it a pure instrumental (lyrics are then omitted), andlyrics_optimizertells the model to write lyrics from the prompt whenlyricsis empty. - Speech (HD / Turbo) -
promptis the text to read,voice_idpicks a system or cloned voice, and you getspeed,volume,pitch,language_boostandchannel(mono/stereo). - Voice Clone -
custom_voice_idnames your new voice (8–256 chars, must start with a letter),clone_target_modelpicks the target speech model, and the cleanup toggles (need_noise_reduction,need_volume_normalization) are here. This is the only path that reads the optionalreference_audioinput - one clip, 10 seconds to 5 minutes.
Shared technicals: output_format, sample_rate, bitrate. The node uploads, submits, polls, downloads and decodes to ComfyUI AUDIO (1 second of silence on skip_error, so batch pipelines keep running).
The inputs that matter
For a beginner, the practical trio is model (which job are you doing), prompt (style, text, or preview text), and - for cloning - reference_audio + custom_voice_id. Everything else is either per-mode polish or technical output format.
Outputs: audio (AUDIO), audio_url, audio_path, result_text, task_id, response. The result_text output is handy for music - it can carry lyrics or generation notes.
Installing it
ComfyUI Manager → search "ComfyUI Seedance", or:
cd ComfyUI/custom_nodes
git clone https://github.com/T8mars/ComfyUI_Seedance.git
cd ../..
python -m pip install -r custom_nodes/ComfyUI_Seedance/requirements.txt
Restart, key from api.seedance.nz/console, Seedance API Config into api_config.
Common issues
- Music rejects your lyrics - if
is_instrumentalis on, lyrics are deliberately omitted. Turn it off to uselyrics. - Clone fails validation -
custom_voice_idmust be 8–256 chars starting with a letter, andreference_audiomust be 10s–5min. Short clips get refused. - Tweaking
speeddoes nothing on music - speech-only control; the node shows/hides fields by mode, but if you switched models mid-workflow the leftover value can confuse. Re-check which model you're on. - Output format surprises -
output_format/sample_rate/bitrateapply across modes; if your downstream audio tool chokes, you usually picked an odd combo. mp3 with a sane sample rate is the safest default.
Voice cloning is the feature people actually come for, and it's genuinely good - but remember the safety frame: a cloned voice leaves your machine and lands on the gateway's servers. Don't run someone's voice without permission; this is exactly the tool that makes that obvious and effortless.
Inputs (22)
| Name | Type | Default | Description |
|---|---|---|---|
| model | COMBO | minimax-speech-2.8-turbo | Choose music, HD/Turbo speech, or voice cloning. | 选择音乐、HD/Turbo 语音或声音克隆。 |
| prompt | STRING | Music style, speech text, or clone preview text according to the selected model. | 按模型填写音乐风格、朗读文本或克隆试听文本。 | |
| lyrics | STRING | Music only: lyrics with optional structure tags. | 仅音乐:歌词,可包含结构标签。 | |
| is_instrumental | BOOLEAN | true | Music only: generate without vocals; lyrics are then omitted. | 仅音乐:生成纯音乐,此时不提交歌词。 |
| lyrics_optimizer | BOOLEAN | false | Music only: generate lyrics from the prompt when lyrics are empty. | 仅音乐:歌词为空时根据提示词生成歌词。 |
| voice_id | STRING | Wise_Woman | Speech only: MiniMax system or cloned voice ID. | 仅语音:MiniMax 系统或克隆音色 ID。 |
| speed | FLOAT | 1.000.5–2 | Speech only: playback speed. | 仅语音:语速。 |
| volume | FLOAT | 1.00.1–10 | Speech only: volume. | 仅语音:音量。 |
| pitch | INT | 0-12–12 | Speech only: pitch adjustment. | 仅语音:音高调整。 |
| language_boost | COMBO | auto | Speech only: language recognition enhancement. | 仅语音:语言识别增强。 |
| output_format | COMBO | mp3 | Music/speech output format. | 音乐或语音输出格式。 |
| sample_rate | COMBO | 32000 | Music/speech output sample rate. | 音乐或语音输出采样率。 |
| bitrate | COMBO | 128000 | Music/speech output bitrate. | 音乐或语音输出码率。 |
| channel | COMBO | 1 | Speech only: mono or stereo. | 仅语音:单声道或双声道。 |
| custom_voice_id | STRING | SeedanceVoice01 | Voice Clone only: unique ID, 8-256 characters, starting with a letter. | 仅声音克隆:唯一 ID,8-256 字符且以字母开头。 |
| clone_target_model | COMBO | minimax-speech-2.8-hd | Voice Clone only: target speech model. | 仅声音克隆:目标语音模型。 |
| need_noise_reduction | BOOLEAN | false | Voice Clone only: reduce reference noise. | 仅声音克隆:降低参考音频噪声。 |
| need_volume_normalization | BOOLEAN | false | Voice Clone only: normalize reference volume. | 仅声音克隆:归一化参考音量。 |
| reference_audioopt | AUDIO | Voice Clone only: one 10-second to 5-minute reference audio. | 仅声音克隆:一段 10 秒到 5 分钟的参考音频。 | |
| api_configopt | SEEDANCE_CONFIG | Connect Seedance API Config; otherwise SEEDANCE_API_KEY is used. | |
| skip_erroropt | BOOLEAN | false | On failure return one second of silence instead of stopping the workflow. | 失败时输出 1 秒静音。 |
| seedopt | INT | 00–18446744073709550000 | ComfyUI cache seed. Fixed reuses the cached result while all other inputs stay unchanged; randomize/increment/decrement starts a new execution. This value is not sent to models without documented seed support. | ComfyUI 缓存种子;Fixed 在其他输入不变时复用缓存,随机、递增或递减会触发新任务。未声明支持 seed 的模型不会收到此参数。 |
Outputs (6)
| Name | Type | Description |
|---|---|---|
| audio | AUDIO | — |
| audio_url | STRING | — |
| audio_path | STRING | — |
| result_text | STRING | — |
| task_id | STRING | — |
| response | STRING | — |