BailianTTSClient 语音合成

BailianTTSClient wraps Alibaba Cloud Bailian / DashScope text-to-speech through the /api/v1/services/audio/tts/SpeechSynthesizer endpoint.

Configuration

Load app.properties or environment variables before calling the client:

BAILIAN_API_KEY=your-bailian-api-key

# Optional. Defaults to https://dashscope.aliyuncs.com
BAILIEN_BASE_URL=https://dashscope.aliyuncs.com

The base URL environment variable is currently named BAILIEN_BASE_URL in code.

Quick Start

This example follows nexus.io.bailian.BailianTTSClientTest.test():

import nexus.io.bailian.BailianTTSClient;
import nexus.io.bailian.tts.BailianTTSResponse;
import nexus.io.exception.GenerateException;
import nexus.io.tio.utils.environment.EnvUtils;
import nexus.io.tio.utils.json.JsonUtils;

public class BailianTTSExample {
  public static void main(String[] args) {
    EnvUtils.load();

    BailianTTSClient client = new BailianTTSClient();
    String model = "cosyvoice-v3.5-plus";
    String voice = "cosyvoice-v3.5-plus-bailian-e46c4292e6504f808be470fe6f9c8b93";

    try {
      BailianTTSResponse response = client.tts(model, voice, "How is the weather today?");
      System.out.println(JsonUtils.toJson(response));
    } catch (GenerateException e) {
      System.out.println(e.getRequestBody());
      System.out.println(e.getResponseBody());
    }
  }
}

The shortcut constructor sends MP3 audio with a 16000 Hz sample rate by default.

Custom Request

Use BailianTTSRequest and BailianTTSInput when you need to control format or sample rate:

import nexus.io.bailian.BailianTTSClient;
import nexus.io.bailian.tts.BailianTTSInput;
import nexus.io.bailian.tts.BailianTTSRequest;
import nexus.io.bailian.tts.BailianTTSResponse;

BailianTTSInput input = new BailianTTSInput();
input.setVoice("cosyvoice-v3.5-plus-bailian-e46c4292e6504f808be470fe6f9c8b93");
input.setText("How is the weather today?");
input.setFormat("mp3");
input.setSample_rate(16000);

BailianTTSRequest request = new BailianTTSRequest();
request.setModel("cosyvoice-v3.5-plus");
request.setInput(input);

BailianTTSResponse response = new BailianTTSClient().tts(request);

You can also pass a key explicitly:

BailianTTSResponse response = new BailianTTSClient().tts(apiKey, request);

Request Fields

Field	Type	Description
model	String	Bailian TTS model name, for example cosyvoice-v3.5-plus.
input.voice	String	Voice ID to synthesize with.
input.text	String	Text to synthesize.
input.format	String	Audio format. The shortcut constructor defaults to mp3.
input.sample_rate	Integer	Audio sample rate. The shortcut constructor defaults to 16000.

Response Fields

Field	Type	Description
request_id	String	Provider request ID.
output.finish_reason	String	Provider finish reason.
output.audio.id	String	Audio asset ID when returned by Bailian.
output.audio.url	String	Remote audio URL when returned by Bailian.
output.audio.data	String	Inline audio data when returned by Bailian.
output.audio.expires_at	Integer	Expiration timestamp for URL-based audio.
usage.characters	Integer	Number of synthesized characters reported by the provider.

Error Handling

BailianTTSClient.generate(...) throws GenerateException for non-2xx HTTP responses. The exception includes the translated request JSON and provider response body:

try {
  BailianTTSResponse response = client.tts(model, voice, text);
} catch (GenerateException e) {
  log.error("Bailian TTS failed: status={}, request={}, response={}",
      e.getStatusCode(), e.getRequestBody(), e.getResponseBody(), e);
}