Nodes/Tikpan Official Nodes/音频|豆包语音合成 2.0
ComfyUI Node

音频|豆包语音合成 2.0

Doubao TTS 2.0 for Chinese narration, with a voice picker instead of IDs

By htrert·Created 5 months ago·Updated 2 months ago· 1
音频|豆包语音合成 2.0
    • 📁_音频路径
    • 🔗_音频链接
    • 🎙️_voice_type
    • 💰_计费字符数
    • 📋_状态日志
    • 🎧_音频流
    💵_福利_💵
    获取密钥请访问
    API_密钥sk-
    合成文本欢迎使用 Tikpan 豆包语音合成 2.0。现在音色已经整理成下拉框,普通用户不用再手动查 voice_type。
    模型doubao-tts-2.0
    音色通用场景|VV 2.0|女|多语种、方言支持|zh_female_vv_uranus_bigtts
    语速1.00
    音量1.00
    音调1.00
    情感默认不传
    音频格式mp3
    采样率24000
    POST重试策略幂等键轻重试
    校验HTTPS证书true
    自定义voice_type
    火山AppID_可选
    资源IDseed-tts-2.0
    接口路径/api/v3/tts/unidirectional/sse
    用户IDtikpan_comfyui_user
    复用本地缓存true
    跳过错误false

    If your workflow ends in spoken Chinese - product narration, short-video voiceovers, character dialogue - this is the node that stops you from hand-typing ByteDance's opaque voice_type IDs. TikpanDoubaoTTS20Node wraps Doubao's Seed-TTS 2.0 through the Tikpan relay, hides the fixed host, and hands you a 25-voice dropdown with human-readable labels like 小何 2.0 / 女 / 清新自然. The author's default text literally says it: "音色已经整理成下拉框,普通用户不用再手动查 voice_type" - the voices are the feature.

    How it works

    You type text, pick a voice and a few prosody sliders, and the node POSTs to Tikpan's bound /api/v3/tts/unidirectional/sse path (Doubao's V3 unidirectional SSE). The returned audio is saved locally and emitted three ways: 📁_音频路径 (file path), 🔗_音频链接 (hosted URL), and 🎧_音频流 (an AUDIO output you can wire straight into a video-composition node). Plus 🎙️_voice_type, 💰_计费字符数 (billed character count - billing is per character), and 📋_状态日志. It's an is_output_node (output-marked) node, but the 🎧_音频流 wire is what feeds downstream muxing.

    The inputs that actually matter

    • API_密钥 - sk- key from tikpan.com.
    • 合成文本 - the text to speak. Per-character billing, so keep it tight.
    • 音色 - 25 preset voices, each with gender/style annotated. Default zh_female_vv_uranus_bigtts (通用 VV 2.0 女声, multilingual + dialect support).
    • 语速 / 音量 / 音调 - speed 0.5–2×, volume 0.1–3×, pitch 0.5–2×. The volume tooltip warns 过高可能爆音 (too loud clips).
    • 情感 - optional emotion tag: happy / sad / angry / fearful / surprised / neutral.
    • 音频格式 and 采样率 - mp3 (default) / wav / pcm, and 24k default sampling up to 48k.

    Optional: 自定义voice_type (for voice cloning ICL or brand-new official voices), 资源ID (seed-tts-2.0 default; the ICL variants are the cloning path), 复用本地缓存 (default on - same text + params hits local cache and avoids a double charge, worth leaving on), and 跳过错误 (returns a silent clip on failure so batch flows survive).

    Installing it

    Same pack, same steps:

    cd ComfyUI/custom_nodes
    git clone https://github.com/htrert/ComfyUI-Tikpan-Pro
    

    restart (or Manager → "Tikpan"). No models to download - this is pure relay + file plumbing.

    Where people get burned

    • Billing is per character. The 💰_计费字符数 output exists so you can watch spend. Long scripts are the real cost driver.
    • Cert verification defaults ON here (true), unlike the new.ip233.com nodes - which is correct behavior, but if you're behind a MITM proxy you'll get cert errors and have to toggle it off. The tooltip says as much.
    • The cache is a money-saver, not a bug. If a repeat run seems to return instantly with no charge, that's 复用本地缓存 working.
    • Voice cloning is a hidden feature. ICL resource IDs + a custom voice_type is the path to voice replication - the dropdown won't tell you this, but the schema will.

    The one-liner: if you need clean, natural Chinese TTS in a graph without memorizing ByteDance's ID scheme, this is the node. It's the "voices in a dropdown" version of Doubao TTS, and for Chinese-first content that's a real quality-of-life win.

    Category👑 Tikpan 官方独家节点/03 音频 Audio

    Inputs (21)

    NameTypeDefaultDescription
    💵_福利_💵COMBO1 options: 🔥 豆包语音合成 2.0 | Tikpan 中转站 | 官方音色下拉 | 按字符计费
    获取密钥请访问COMBO1 options: 👉 https://tikpan.com (官方授权 Key 获取入口)
    API_密钥STRINGsk-Tikpan 平台的 API 密钥,以 sk- 开头,从 https://tikpan.com 获取
    合成文本STRING欢迎使用 Tikpan 豆包语音合成 2.0。现在音色已经整理成下拉框,普通用户不用再手动查 voice_type。需要被合成为语音的文本,按字符计费
    模型COMBOdoubao-tts-2.0本节点使用的豆包 TTS 模型版本
    音色COMBO通用场景|VV 2.0|女|多语种、方言支持|zh_female_vv_uranus_bigtts选择说话音色:每个对应不同性别/年龄/方言/情感风格
    语速FLOAT1.000.5–2语速倍率:1.0 标准,>1 更快,<1 更慢
    音量FLOAT1.000.1–3音量倍率:1.0 标准;过高可能爆音
    音调FLOAT1.000.5–2音调倍率:>1 变尖,<1 变沉
    情感COMBO默认不传情感标签:happy 欢快 / sad 悲伤 / angry 愤怒 等
    音频格式COMBOmp3音频编码:mp3 通用,wav 无损未压缩,pcm 原始流
    采样率COMBO24000输出音频采样率(Hz);越高越清晰但文件越大
    POST重试策略COMBO幂等键轻重试网络异常重试方式;带幂等键更安全
    校验HTTPS证书BOOLEANtrue默认开启;遇到本地证书问题再关闭(不推荐关闭)
    自定义voice_typeoptSTRING当“音色”选择自定义时使用;也可填写复刻音色或官方新上线音色的 voice_type。
    火山AppID_可选optSTRINGTikpan 中转通常只需要 Tikpan API Key;如你的中转要求透传火山 AppID,可填写。
    资源IDoptCOMBOseed-tts-2.0上游火山资源 ID,一般保持默认;ICL 系列用于复刻音色
    接口路径optSTRING/api/v3/tts/unidirectional/sse默认绑定 Tikpan 中转站的豆包 V3 单向 SSE 路径;一般不要改。
    用户IDoptSTRINGtikpan_comfyui_user调用方标识,便于上游做用量统计;保持默认即可
    复用本地缓存optBOOLEANtrue开启后同一文本同一参数命中缓存时复用,避免重复扣费
    跳过错误optBOOLEANfalse开启后异常时返回空音频,不打断后续工作流

    Outputs (6)

    NameTypeDescription
    📁_音频路径STRING
    🔗_音频链接STRING
    🎙️_voice_typeSTRING
    💰_计费字符数STRING
    📋_状态日志STRING
    🎧_音频流AUDIO