<dependencies>
    <!-- Spring Boot Web 模塊 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>

/src
 └── main
     ├── java
     │   └── com
     │       └── icoderoad
     │           └── tts
     │               ├── UnifiedTtsProperties.java
     │               ├── UnifiedTtsService.java
     │               └── controller
     │                   └── TtsController.java
     └── resources
         └── application.properties

unified-tts.host=https://unifiedtts.com
unified-tts.api-key=your-api-key-here

package com.icoderoad.tts;


import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Configuration;


/**
 * UnifiedTTS 配置屬性綁定類(lèi)
 */
@Data
@Configuration
@ConfigurationProperties(prefix = "unified-tts")
public class UnifiedTtsProperties {


    /** 接口主機(jī)地址 */
    private String host;


    /** API Key（從 UnifiedTTS 控制臺(tái)獲?。?*/
    private String apiKey;
}

package com.icoderoad.tts.model;


import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;


/**
 * UnifiedTTS 請(qǐng)求參數(shù)模型
 */
@Data
@AllArgsConstructor
@NoArgsConstructor
public class UnifiedTtsRequest {


    private String model;
    private String voice;
    private String text;
    private Double speed;
    private Double pitch;
    private Double volume;
    private String format;
}

package com.icoderoad.tts.model;


import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;


/**
 * UnifiedTTS 響應(yīng)結(jié)果封裝
 */
@Data
@AllArgsConstructor
@NoArgsConstructor
public class UnifiedTtsResponse {


    private boolean success;
    private String message;
    private long timestamp;
    private UnifiedTtsResponseData data;


    @Data
    @AllArgsConstructor
    @NoArgsConstructor
    public static class UnifiedTtsResponseData {
        @JsonProperty("request_id")
        private String requestId;


        @JsonProperty("audio_url")
        private String audioUrl;


        @JsonProperty("file_size")
        private long fileSize;
    }
}

package com.icoderoad.tts.service;


import com.icoderoad.tts.UnifiedTtsProperties;
import com.icoderoad.tts.model.UnifiedTtsRequest;
import org.springframework.http.*;
import org.springframework.stereotype.Service;
import org.springframework.web.client.RestClient;


import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;


/**
 * UnifiedTTS 語(yǔ)音合成服務(wù)
 */
@Service
public class UnifiedTtsService {


    private final RestClient restClient;
    private final UnifiedTtsProperties properties;


    public UnifiedTtsService(RestClient restClient, UnifiedTtsProperties properties) {
        this.restClient = restClient;
        this.properties = properties;
    }


    /**
     * 調(diào)用 UnifiedTTS 接口生成音頻字節(jié)流
     */
    public byte[] synthesize(UnifiedTtsRequest request) {
        ResponseEntity<byte[]> response = restClient.post()
                .uri(properties.getHost() + "/api/v1/common/tts-sync")
                .contentType(MediaType.APPLICATION_JSON)
                .accept(MediaType.APPLICATION_OCTET_STREAM, MediaType.valueOf("audio/mpeg"))
                .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());
    }


    /**
     * 將生成的音頻寫(xiě)入文件
     */
    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: " + outputPath, e);
        }
    }
}