GLM-TTS批量处理教程：JSONL任务文件编写规范详解

1. 引言

1.1 技术背景与应用场景

随着AI语音合成技术的快速发展，高质量、个性化的文本转语音（TTS）需求日益增长。GLM-TTS作为智谱开源的一款先进语音合成模型，在零样本语音克隆、情感表达控制和音素级发音调节方面表现出色，广泛应用于有声书制作、虚拟主播、智能客服等场景。

在实际工程落地中，单次语音合成已无法满足大规模内容生成的需求。例如，一个包含数百段旁白的教育课程或需要多角色配音的音频剧项目，都需要高效的批量处理能力。此时，通过结构化任务文件驱动的批量推理机制成为提升效率的关键。

1.2 批量处理的核心价值

GLM-TTS提供的批量推理功能支持使用JSONL格式的任务文件进行自动化语音生成，具备以下优势：

高效性：一次性提交多个合成任务，减少人工干预
一致性：统一参数配置确保输出风格一致
可复现性：固定随机种子实现结果可重复
灵活性：支持不同参考音频、文本和命名规则组合

本文将重点解析JSONL任务文件的编写规范，帮助开发者掌握批量处理的最佳实践。

2. JSONL任务文件基础概念

2.1 什么是JSONL？

JSONL（JSON Lines）是一种轻量级数据交换格式，每行是一个独立的JSON对象。其核心特点是：

每行代表一条记录
行与行之间互不影响
易于流式读取和处理
适合大规模数据集处理

示例：

{"name": "张三", "age": 30} {"name": "李四", "age": 25}

2.2 GLM-TTS中的JSONL作用

在GLM-TTS批量推理中，JSONL文件用于定义每个语音合成任务的具体参数。系统会逐行读取并执行，直到所有任务完成。

重要提示：JSONL文件必须以.jsonl或.json为扩展名，且每一行必须是合法的JSON对象，末尾不能有多余逗号。

3. JSONL字段详解与编写规范

3.1 必填字段说明

`prompt_audio`

含义：参考音频文件路径
类型：字符串
要求：
- 路径需相对于GLM-TTS根目录
- 支持WAV、MP3等常见格式
- 推荐长度3–10秒，清晰人声

示例：

"prompt_audio": "examples/prompt/audio1.wav"

`input_text`

含义：要合成的目标文本
类型：字符串
要求：
- 支持中文、英文及混合输入
- 建议单条不超过200字符
- 避免特殊符号乱码

示例：

"input_text": "欢迎来到人工智能时代"

3.2 可选字段说明

`prompt_text`

含义：参考音频对应的文本内容
作用：辅助模型对齐音色特征，提高克隆准确度
建议：若已知音频内容，应尽量填写
示例：
```
"prompt_text": "今天天气真好"
```

`output_name`

含义：输出音频文件名（不含扩展名）
默认值：按顺序生成output_0001,output_0002...
建议：使用有意义的命名便于后期管理
示例：
```
"output_name": "chapter1_intro"
```

3.3 完整JSONL示例文件

{"prompt_text": "你好，我是小王", "prompt_audio": "voices/wang.wav", "input_text": "欢迎收听本期节目", "output_name": "greeting"} {"prompt_text": "大家好，我是李老师", "prompt_audio": "voices/li.wav", "input_text": "今天我们学习语音合成技术", "output_name": "lesson_intro"} {"prompt_audio": "voices/zhang.wav", "input_text": "这个模型真的很强大！", "output_name": "review_positive"}

注意：第三行省略了prompt_text，系统将自动进行语音识别补全（如有ASR模块支持）。

4. 实践操作指南

4.1 准备工作流程

整理参考音频
- 统一存放至examples/prompt/或自定义目录
- 文件命名清晰（如 speaker_a.wav）
编写文本清单
- 使用Excel或文本编辑器列出所有待合成文本
- 包含字段：参考音频、参考文本（可选）、目标文本、输出名称
转换为JSONL
- 手动编写或通过脚本批量生成
- 确保每行JSON语法正确

4.2 自动生成JSONL的Python脚本示例

import json tasks = [ { "prompt_audio": "voices/narrator.wav", "prompt_text": "这是一个示例音频", "input_text": "第一章：人工智能的发展历程", "output_name": "chapter_01_title" }, { "prompt_audio": "voices/narrator.wav", "input_text": "从图灵测试到深度学习，AI经历了多次浪潮。", "output_name": "chapter_01_content_01" } ] # 写入JSONL文件 with open('batch_tasks.jsonl', 'w', encoding='utf-8') as f: for task in tasks: f.write(json.dumps(task, ensure_ascii=False) + '\n') print("JSONL任务文件已生成：batch_tasks.jsonl")

4.3 上传与执行步骤

进入WebUI「批量推理」标签页
点击「上传 JSONL 文件」按钮
选择本地生成的.jsonl文件
设置全局参数：
- 采样率：24000 / 32000
- 随机种子：42（推荐固定）
- 输出目录：@outputs/batch
点击「🚀 开始批量合成」

系统将依次处理每个任务，并实时显示进度日志。

5. 常见问题与调试技巧

5.1 典型错误及解决方案

错误现象	可能原因	解决方法
任务跳过或失败	JSON格式不合法	使用在线JSON验证工具检查
找不到音频文件	路径错误或权限不足	检查路径是否相对根目录正确
输出文件名重复	`output_name`冲突	确保每条任务命名唯一
编码乱码	文件未保存为UTF-8	用文本编辑器另存为UTF-8编码

5.2 调试建议

小规模测试先行：先用2–3条数据验证流程
启用日志查看：关注控制台输出的详细错误信息
分段处理长文本：避免单次合成过长导致质量下降
统一音频预处理：对参考音频进行降噪、归一化处理

6. 最佳实践与性能优化

6.1 工程化建议

建立标准模板创建标准化的JSONL模板文件，供团队成员复用：
```
{"prompt_audio": "", "prompt_text": "", "input_text": "", "output_name": ""}
```
版本化管理任务文件将JSONL文件纳入Git等版本控制系统，便于追溯修改历史。
自动化流水线集成结合CI/CD工具实现“文本更新 → 自动生成JSONL → 触发批量合成”的自动化流程。