Nodes/ComfyUI Seedance/MiniMax 音乐/语音/声音克隆(4 合 1)
ComfyUI Node

MiniMax 音乐/语音/声音克隆(4 合 1)

Music, speech, and a voice clone in one node

By T8mars·Created 2 months ago·Updated 3 days ago· 31
MiniMax 音乐/语音/声音克隆(4 合 1)
  • reference_audio
  • api_config
  • audio
  • audio_url
  • audio_path
  • result_text
  • task_id
  • response
modelminimax-speech-2.8-turbo
prompt
lyrics
is_instrumentaltrue
lyrics_optimizerfalse
voice_idWise_Woman
speed1.00
volume1.0
pitch0
language_boostauto
output_formatmp3
sample_rate32000
bitrate128000
channel1
custom_voice_idSeedanceVoice01
clone_target_modelminimax-speech-2.8-hd
need_noise_reductionfalse
need_volume_normalizationfalse
skip_errorfalse
seed0

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 - prompt describes the style; lyrics takes lyrics with optional structure tags. is_instrumental makes it a pure instrumental (lyrics are then omitted), and lyrics_optimizer tells the model to write lyrics from the prompt when lyrics is empty.
  • Speech (HD / Turbo) - prompt is the text to read, voice_id picks a system or cloned voice, and you get speed, volume, pitch, language_boost and channel (mono/stereo).
  • Voice Clone - custom_voice_id names your new voice (8–256 chars, must start with a letter), clone_target_model picks the target speech model, and the cleanup toggles (need_noise_reduction, need_volume_normalization) are here. This is the only path that reads the optional reference_audio input - 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_instrumental is on, lyrics are deliberately omitted. Turn it off to use lyrics.
  • Clone fails validation - custom_voice_id must be 8–256 chars starting with a letter, and reference_audio must be 10s–5min. Short clips get refused.
  • Tweaking speed does 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/bitrate apply 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.

CategorySeedance

Inputs (22)

NameTypeDefaultDescription
modelCOMBOminimax-speech-2.8-turboChoose music, HD/Turbo speech, or voice cloning. | 选择音乐、HD/Turbo 语音或声音克隆。
promptSTRINGMusic style, speech text, or clone preview text according to the selected model. | 按模型填写音乐风格、朗读文本或克隆试听文本。
lyricsSTRINGMusic only: lyrics with optional structure tags. | 仅音乐:歌词,可包含结构标签。
is_instrumentalBOOLEANtrueMusic only: generate without vocals; lyrics are then omitted. | 仅音乐:生成纯音乐,此时不提交歌词。
lyrics_optimizerBOOLEANfalseMusic only: generate lyrics from the prompt when lyrics are empty. | 仅音乐:歌词为空时根据提示词生成歌词。
voice_idSTRINGWise_WomanSpeech only: MiniMax system or cloned voice ID. | 仅语音:MiniMax 系统或克隆音色 ID。
speedFLOAT1.000.5–2Speech only: playback speed. | 仅语音:语速。
volumeFLOAT1.00.1–10Speech only: volume. | 仅语音:音量。
pitchINT0-12–12Speech only: pitch adjustment. | 仅语音:音高调整。
language_boostCOMBOautoSpeech only: language recognition enhancement. | 仅语音:语言识别增强。
output_formatCOMBOmp3Music/speech output format. | 音乐或语音输出格式。
sample_rateCOMBO32000Music/speech output sample rate. | 音乐或语音输出采样率。
bitrateCOMBO128000Music/speech output bitrate. | 音乐或语音输出码率。
channelCOMBO1Speech only: mono or stereo. | 仅语音:单声道或双声道。
custom_voice_idSTRINGSeedanceVoice01Voice Clone only: unique ID, 8-256 characters, starting with a letter. | 仅声音克隆:唯一 ID,8-256 字符且以字母开头。
clone_target_modelCOMBOminimax-speech-2.8-hdVoice Clone only: target speech model. | 仅声音克隆:目标语音模型。
need_noise_reductionBOOLEANfalseVoice Clone only: reduce reference noise. | 仅声音克隆:降低参考音频噪声。
need_volume_normalizationBOOLEANfalseVoice Clone only: normalize reference volume. | 仅声音克隆:归一化参考音量。
reference_audiooptAUDIOVoice Clone only: one 10-second to 5-minute reference audio. | 仅声音克隆:一段 10 秒到 5 分钟的参考音频。
api_configoptSEEDANCE_CONFIGConnect Seedance API Config; otherwise SEEDANCE_API_KEY is used.
skip_erroroptBOOLEANfalseOn failure return one second of silence instead of stopping the workflow. | 失败时输出 1 秒静音。
seedoptINT00–18446744073709550000ComfyUI 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)

NameTypeDescription
audioAUDIO
audio_urlSTRING
audio_pathSTRING
result_textSTRING
task_idSTRING
responseSTRING