蚜质是丈通过 start.spring.io 或其他构建基础的Spring Boot工程根据你构建应用的需要增加一些依赖比如最后用接口提供服务的话可以加入web模块org.springframework.bootspring-boot-starter-web2. 注册 UnifiedTTS获取 API Key前往 UnifiedTTS 官网注册账号直接GitHub登录即可从左侧菜单进入“API密钥”页面创建 API Key创建API Key存好API Key后续需要使用3. 集成 UnifiedTTS API下面根据API 文档https://unifiedtts.com/zh/api-docs/tts-sync 实现一个可运行的参考实现包括配置文件、请求模型、服务类与控制器。3.1 配置文件application.propertiesunified-tts.hosthttps://unifiedtts.comunified-tts.api-keyyour-api-key-here这里unifiedtts.api-key参数记得替换成之前创建的ApiKey。3.2 配置加载类DataConfigurationProperties(prefix unified-tts)public class UnifiedTtsProperties {private String host;private String apiKey;}3.3 请求封装和响应封装DataAllArgsConstructorNoArgsConstructorpublic class UnifiedTtsRequest {private String model;private String voice;private String text;private Double speed;private Double pitch;private Double volume;private String format;}DataAllArgsConstructorNoArgsConstructorpublic class UnifiedTtsResponse {private boolean success;private String message;private long timestamp;private UnifiedTtsResponseData data;DataAllArgsConstructorNoArgsConstructorpublic static class UnifiedTtsResponseData {JsonProperty(request_id)private String requestId;JsonProperty(audio_url)private String audioUrl;JsonProperty(file_size)private long fileSize;}}UnifiedTTS 抽象了不同模型的请求这样用户可以用同一套请求参数标准来实现对不同TTS模型的调用这个非常方便。所以为了简化TTS的客户端调用非常推荐使用 UnifiedTTS。3.3 服务实现调用 UnifiedTTS使用 Spring Boot自带的RestClient HTTP客户端来实现UnifiedTTS的功能实现类提供两个实现接收音频字节并返回。Servicepublic class UnifiedTtsService {private final RestClient restClient;private final UnifiedTtsProperties properties;public UnifiedTtsService(RestClient restClient, UnifiedTtsProperties properties) {this.restClient restClient;this.properties properties;}/*** 调用 UnifiedTTS 同步 TTS 接口返回音频字节数据。**请求头**Content-Type: application/json*X-API-Key: 来自配置的 API Key*Accept: 接受二进制流或常见 mp3/mpeg 音频类型*** param request 模型、音色、文本、速度/音调/音量、输出格式等参数* return 音频二进制字节例如 mp3* throws IllegalStateException 当服务端返回非 2xx 或无内容时抛出*/public byte[] synthesize(UnifiedTtsRequest request) {ResponseEntity response restClient.post().uri(/api/v1/common/tts-sync).contentType(MediaType.APPLICATION_JSON).accept(MediaType.APPLICATION_OCTET_STREAM, MediaType.valueOf(audio/mpeg), MediaType.valueOf(audio/mp3)).header(X-API-Key, properties.getApiKey()).body(request).retrieve().toEntity(byte[].class);if (response.getStatusCode().is2xxSuccessful() response.getBody() ! null) {return response.getBody();}throw new IllegalStateException(UnifiedTTS synthesize failed: response.getStatusCode());}/*** 调用合成并将音频写入指定文件。**若输出路径的父目录不存在会自动创建失败时抛出运行时异常。** param request TTS 请求参数* param outputPath 目标文件路径例如 output.mp3* return 实际写入的文件路径*/public Path synthesizeToFile(UnifiedTtsRequest request, Path outputPath) {byte[] data synthesize(request);try {if (outputPath.getParent() ! null) {Files.createDirectories(outputPath.getParent());}Files.write(outputPath, data);return outputPath;} catch (IOException e) {throw new RuntimeException(Failed to write TTS output to file: outputPath, e);}}}3.4 单元测试SpringBootTestclass UnifiedTtsServiceTest {Autowiredprivate UnifiedTtsService unifiedTtsService;Testvoid testRealSynthesizeAndDownloadToFile() throws Exception {UnifiedTtsRequest req new UnifiedTtsRequest(edge-tts,en-US-JennyNeural,Hello, this is a test of text to speech synthesis.,1.0,1.0,1.0,mp3);// 调用真实接口断言返回结构UnifiedTtsResponse resp unifiedTtsService.synthesize(req);assertNotNull(resp);assertTrue(resp.isSuccess(), Response should be success);assertNotNull(resp.getData(), Response data should not be null);assertNotNull(resp.getData().getAudioUrl(), audio_url should be present);// 在当前工程目录下生成测试结果目录并写入文件Path projectDir Paths.get(System.getProperty(user.dir));Path resultDir projectDir.resolve(test-result);Files.createDirectories(resultDir);Path out resultDir.resolve(System.currentTimeMillis() .mp3);Path written unifiedTtsService.synthesizeToFile(req, out);System.out.println(UnifiedTTS test output: written.toAbsolutePath());assertTrue(Files.exists(written), Output file should exist);assertTrue(Files.size(written) 0, Output file size should be 0);}}4. 运行与验证执行单元测试之后可以在工程目录test-result下找到生成的音频文件5. 常用参数与音色选择目前支持的常用参数如下图所示对于model和voice参数可以因为内容较多可以前往API文档查看。小结本文展示了如何在 Spring Boot 中集成 UnifiedTTS 的 EdgeTTS 能力实现文本转语音并输出为 mp3。UnifiedTTS 通过统一的 API 屏蔽了不同 TTS 模型的差异使你无需维护多个 SDK即可在成本与效果之间自由切换。根据业务需求你可以进一步完善异常处理、缓存与并发控制实现更可靠的生产级 TTS 服务。