Nodes/Tikpan Official Nodes/音频|Gemini 3.1 Flash TTS
ComfyUI Node

音频|Gemini 3.1 Flash TTS

Gemini 3.1 Flash TTS — thirty preset voices, billed in tokens

By htrert·Created 5 months ago·Updated 2 months ago· 1
音频|Gemini 3.1 Flash TTS
    • 📁_音频路径
    • 🔗_音频链接
    • 💰_输入输出用量
    • 🧾_接口路径
    • 📋_状态日志
    • 🎧_音频流
    💵_福利_💵
    获取密钥请访问
    API_密钥sk-
    合成文本Say warmly: Welcome to Tikpan Gemini 3.1 Flash TTS preview. This voice is generated for a commercial-ready workflow.
    模型gemini-3.1-flash-tts-preview
    调用方式geminitts 原生
    音色Kore|坚定清晰|Firm|适合商务说明、教程、权威旁白
    语气指令自然、清晰、商业旁白风格
    语言代码自动
    采样率24000
    POST重试策略幂等键轻重试
    校验HTTPS证书true
    自定义voice_name
    复用本地缓存true
    跳过错误false

    Google's Gemini TTS models are closed and API-only, and this node is the relay path into them from a ComfyUI graph. TikpanGemini31FlashTTSNode wraps gemini-3.1-flash-tts-preview behind a Tikpan key, and the headline feature is the 31-voice preset picker - named voices like Kore (Firm, for business narration), Puck (Upbeat, short-video friendly), Charon (Informative), Fenrir (Excitable) - each annotated with style and use case, so you pick a vibe instead of guessing a voice ID. It's positioned as low-latency TTS for narration and 口播 (spoken ad copy) work, billed per input/output token rather than per character.

    How it works

    Text goes to the relay's Gemini TTS endpoint; the node handles the streaming response, writes the audio, and hands back the usual six outputs: 📁_音频路径, 🔗_音频链接, 💰_输入输出用量 (token usage - this is your billing receipt), 🧾_接口路径 (which endpoint protocol ran), 📋_状态日志, and 🎧_音频流 (AUDIO for downstream nodes). The 调用方式 field is the interesting lever: geminitts 原生 (native, most stable - default), gemini 原生, or openai 兼容 (most interoperable if you're swapping this node for an OpenAI-style consumer). Pick native and leave it.

    The inputs that actually matter

    • API_密钥 - sk- from tikpan.com.
    • 合成文本 - text to speak; the tooltip notes it supports mixed Chinese/English and multiple languages.
    • 音色 - 31 presets. Kore (default) is the business-narration workhorse; Puck is the short-video energy voice.
    • 语气指令 - a natural-language delivery instruction ("像纪录片旁白一样说", "低声说") merged into the text. This is the expressive knob the Doubao node fakes with emotion tags - Gemini takes actual prose direction.
    • 语言代码 - auto, or force zh-CN / en-US / ja-JP / ko-KR / yue-HK / fr-FR / de-DE / es-ES.
    • 采样率 - 24000 Hz only, per the schema. Fine for narration.

    Optional: 自定义voice_name (new official voices or relay aliases), 复用本地缓存 (default on - same text+params hits local cache and avoids a double token charge), 跳过错误 (silent clip on failure to keep batch flows alive).

    Installing it

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

    restart (or Manager → "Tikpan"). No models, no heavy deps.

    Where people get burned

    • Token billing is sneaky. It's billed on input and output tokens, and the 💰_输入输出用量 output exists so you can actually watch it. Long instructions + long text = real spend; the local cache helps on repeats.
    • Cert verification defaults ON. Correct behavior, but a corporate proxy will throw cert errors until you toggle 校验HTTPS证书.
    • Don't overuse the instruction field. 语气指令 is powerful but every token you add is billed - a short, specific delivery note beats a paragraph.
    • Three protocols, one node. If a workflow that previously used an OpenAI-compatible consumer stops working after a swap, the 调用方式 setting is the first thing to check.

    Verdict: the strongest pure-voice picker in the pack for expressive multilingual narration, with the caveat that token metering makes the per-character Doubao node cheaper for long Chinese scripts. Choose by what you're voicing, not by hype.

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

    Inputs (15)

    NameTypeDefaultDescription
    💵_福利_💵COMBO1 options: 🔥 gemini-3.1-flash-tts-preview 文字转语音 | 按输入/输出 token 计费
    获取密钥请访问COMBO1 options: 👉 https://tikpan.com (官方授权 Key 获取入口)
    API_密钥STRINGsk-Tikpan 平台的 API 密钥,以 sk- 开头,从 https://tikpan.com 获取
    合成文本STRINGSay warmly: Welcome to Tikpan Gemini 3.1 Flash TTS preview. This voice is generated for a commercial-ready workflow.需要被合成为语音的文本,支持中英文及多语种混合
    模型COMBOgemini-3.1-flash-tts-preview本节点使用的 TTS 模型
    调用方式COMBOgeminitts 原生走哪个接口协议:geminitts 原生最稳;OpenAI 兼容更通用
    音色COMBOKore|坚定清晰|Firm|适合商务说明、教程、权威旁白选择说话音色:每个音色对应不同的性别/语种/风格
    语气指令STRING自然、清晰、商业旁白风格会作为自然语言指令合并到文本前面,例如:欢快地说、低声说、像纪录片旁白一样说。
    语言代码COMBO自动强制指定发音语言;自动=由模型识别
    采样率COMBO24000输出音频采样率(Hz)
    POST重试策略COMBO幂等键轻重试网络异常重试方式;带幂等键更安全
    校验HTTPS证书BOOLEANtrue默认开启;遇到本地证书问题再关闭(不推荐关闭)
    自定义voice_nameoptSTRING选择“自定义 voice_name”时填写,用于官方新增音色或中转站自定义别名。
    复用本地缓存optBOOLEANtrue相同文本和参数命中缓存时直接返回本地音频,减少误重复扣费。
    跳过错误optBOOLEANfalse批量工作流可开启。失败时返回空音频和错误日志,不中断整个工作流。

    Outputs (6)

    NameTypeDescription
    📁_音频路径STRING
    🔗_音频链接STRING
    💰_输入输出用量STRING
    🧾_接口路径STRING
    📋_状态日志STRING
    🎧_音频流AUDIO