音频|speech-2.8-hd 高清语音合成
Studio-grade TTS with 61 voices, pauses, and sound effects
- 📁_音频路径
- 🔗_音频链接
- 🆔_任务ID
- 🆔_文件ID
- 💰_计费字符数
- 📋_状态日志
- 🎧_音频流
MiniMax's speech-2.8-hd is their high-definition text-to-speech, and this node is a remarkably complete wrapper around it - 61 voices, per-language pronunciation boosting, speed/pitch/volume, emotion tags, a tone dictionary for name pronunciation, even a voice-blending JSON input. If you've ever fought a TTS node that gives you one model, one voice, and one rate, this is the opposite problem: the options are the feature. It's aimed at the pack's core audience of Chinese e-commerce content producers, but the voice list and language controls make it work for English narration too.
The mechanism under the hood is MiniMax's T2A service reached through Tikpan's relay (/minimax/v1/t2a_v2 synchronous, or the async variant for long text), and the node does a couple of smart things for you. The default return mode is hex - the audio comes back inline as hex and gets decoded locally into a proper audio file, which is more reliable than chasing a hosted URL. And it defaults 复用本地缓存 to on: identical text plus identical params hit a local cache and return the saved audio instead of re-billing you. That last one is genuinely considerate - failed or repeated runs are how people accidentally burn TTS credit.
The inputs that matter (and the syntax worth knowing)
合成文本- the text, and it supports MiniMax's control syntax:<#0.5#>inserts a 0.5-second pause, and(laughs),(sighs),(coughs)add sound effects. This is the single best lever for making TTS sound like a person instead of a robot.音色- 61 voices, each labeled with gender/age/style in Chinese. The default is a Mandarin executive male voice.语速/音量/音调- rate and level multipliers, plus semitone pitch.情绪- happy/sad/angry etc.; leave at default to skip.语言增强- boost a specific language's pronunciation,autootherwise.采样率/比特率/音频格式/声道数- output quality knobs; mp3/32000/128000 mono is a fine starting point.开启字幕- returns a subtitle timeline alongside the audio if you want to burn captions.自定义voice_id,音色混合_JSON,发音字典,声音效果- the advanced lane: cloned/designed voices, voice blending with weights, per-word tone dict, and effects likespacious_echo.
Outputs are 🎧_音频流 (AUDIO), 📁_音频路径, 🔗_音频链接, 🆔_任务ID, 🆔_文件ID, 💰_计费字符数, and 📋_状态日志 - wire the AUDIO stream into a save/preview node and keep 计费字符数 handy for cost tracking.
Install and first run
cd ComfyUI/custom_nodes
git clone https://github.com/htrert/ComfyUI-Tikpan-Pro
Restart (or Manager → "Tikpan"), paste your sk- key, type a sentence with a <#0.5#> pause and a (laughs), run. Nothing downloads; the model is server-side. Then start exploring voices - that's where most of the fun is.
Common issues
The pack-wide 401/402/429 family applies. TTS-specific: check 计费字符数 before long re-runs (repeated long text is how you discover the pricing), and keep 复用本地缓存 on so identical re-runs don't re-bill. If a sync call times out on long text, switch 调用方式 to async and collect via the task ID. If 🎧_音频流 won't preview but 📁_音频路径 has a file, the render succeeded - the preview gap is local. And the 校验HTTPS证书 toggle defaults to on here, so local-proxy setups that trip SSL should look there first.
Inputs (32)
| Name | Type | Default | Description |
|---|---|---|---|
| 💵_福利_💵 | COMBO | 1 options: 🔥 speech-2.8-hd 高清语音合成 | 自定义音色/复刻音色按上游规则额外计费 | |
| 获取密钥请访问 | COMBO | 1 options: 👉 https://tikpan.com (官方授权 Key 获取入口) | |
| API_密钥 | STRING | sk- | Tikpan 平台的 API 密钥,以 sk- 开头,从 https://tikpan.com 获取 |
| 合成文本 | STRING | 欢迎使用 Tikpan speech-2.8-hd。你可以在文本中加入 <#0.5#> 控制停顿,也可以使用 (laughs) 或 (sighs) 这类音效标签。 | 需要被合成为语音的文本;支持 <#秒数#> 停顿、(laughs) 音效标签 |
| 模型 | COMBO | speech-2.8-hd | 本节点使用的语音合成模型 |
| 调用方式 | COMBO | 同步语音 /t2a_v2 | 同步=直接等待返回;异步=适合长文本,配合任务查询节点 |
| 音色 | COMBO | 中文普通话|可靠管理者|稳重商务男声,适合企业旁白|Chinese (Mandarin)_Reliable_Executive | 选择说话人音色:每个音色对应不同的性别/年龄/风格 |
| 语言增强 | COMBO | auto | 强化某种语言的发音;auto=自动识别 |
| 语速 | FLOAT | 1.000.5–2 | 语速倍率:1.0 标准,>1 更快,<1 更慢 |
| 音量 | FLOAT | 1.00–10 | 音量倍率:1.0 标准;过高可能爆音 |
| 音调 | INT | 0-12–12 | 调高半音:正数变尖,负数变沉 |
| 情绪 | COMBO | 默认不传 | 情绪标签:happy 欢快 / sad 悲伤 / angry 愤怒 等 |
| 采样率 | COMBO | 32000 | 输出音频采样率(Hz);越高越清晰但文件越大 |
| 比特率 | COMBO | 128000 | 音频比特率;越高音质越好文件越大 |
| 音频格式 | COMBO | mp3 | 音频编码:mp3 通用,wav 无损未压缩,flac 无损压缩 |
| 声道数 | COMBO | 1 | 1=单声道(更小),2=立体声 |
| POST重试策略 | COMBO | 幂等键轻重试 | 网络异常重试方式;带幂等键更安全 |
| 校验HTTPS证书 | BOOLEAN | true | 默认开启;遇到本地证书问题再关闭(不推荐关闭) |
| 自定义voice_idopt | STRING | 选择“自定义 voice_id”时填写;也兼容复刻音色、音色设计和官方新上线 voice_id。 | |
| 同步返回格式opt | COMBO | hex | 同步模式返回音频的方式:hex 内联十六进制;url 云端链接 |
| 发音字典_tone_每行一条opt | STRING | 示例:燕少飞/(yan4)(shao3)(fei1) 或 omg/oh my god | |
| 音色混合_JSONopt | STRING | 高级参数,示例:[{"voice_id":"xxx","weight":70},{"voice_id":"yyy","weight":30}] | |
| 声音效果opt | STRING | 示例:spacious_echo。留空则不传 sound_effects。 | |
| 音色修饰_pitchopt | INT | 0-100–100 | 音高微调:正数变尖,负数变沉 |
| 音色修饰_intensityopt | INT | 0-100–100 | 情感强度微调 |
| 音色修饰_timbreopt | INT | 0-100–100 | 音色质感微调 |
| 开启字幕opt | BOOLEAN | false | 开启后会同时返回字幕时间轴 |
| 字幕类型opt | COMBO | sentence | 字幕粒度:sentence 按句;word 按词 |
| 最长等待秒数opt | INT | 90030–7200 | 异步任务等待上限秒数 |
| 轮询间隔秒数opt | INT | 53–60 | 异步任务轮询间隔秒数 |
| 复用本地缓存opt | BOOLEAN | true | 相同文本和参数命中缓存时直接返回本地音频,减少误重复扣费。 |
| 跳过错误opt | BOOLEAN | false | 批量工作流可开启。失败时返回空音频和错误日志,不中断整个工作流。 |
Outputs (7)
| Name | Type | Description |
|---|---|---|
| 📁_音频路径 | STRING | — |
| 🔗_音频链接 | STRING | — |
| 🆔_任务ID | STRING | — |
| 🆔_文件ID | STRING | — |
| 💰_计费字符数 | STRING | — |
| 📋_状态日志 | STRING | — |
| 🎧_音频流 | AUDIO | — |