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