程序包 io.agentscope.core.model.tts

类 DashScopeRealtimeTTSModel.Builder

java.lang.Object

io.agentscope.core.model.tts.DashScopeRealtimeTTSModel.Builder

封闭类:

DashScopeRealtimeTTSModel

public static class DashScopeRealtimeTTSModel.Builder
extends Object

Builder for constructing DashScopeRealtimeTTSModel instances.

构造器概要

构造器

构造器	说明
Builder()

方法概要

修饰符和类型	方法	说明
DashScopeRealtimeTTSModel.Builder	apiKey(String apiKey)	Sets the API key for DashScope authentication.
DashScopeRealtimeTTSModel	build()	Builds the DashScopeRealtimeTTSModel instance.
DashScopeRealtimeTTSModel.Builder	format(String format)	Sets the audio format.
DashScopeRealtimeTTSModel.Builder	languageType(String languageType)	Sets the language type for synthesis.
DashScopeRealtimeTTSModel.Builder	mode(DashScopeRealtimeTTSModel.SessionMode mode)	Sets the session mode.
DashScopeRealtimeTTSModel.Builder	modelName(String modelName)	Sets the TTS model name.
DashScopeRealtimeTTSModel.Builder	sampleRate(int sampleRate)	Sets the audio sample rate.
DashScopeRealtimeTTSModel.Builder	voice(String voice)	Sets the voice for synthesis.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

Builder

public Builder()

方法详细资料

apiKey

public DashScopeRealtimeTTSModel.Builder apiKey(String apiKey)

Sets the API key for DashScope authentication.

参数:

apiKey - the API key

返回:

this builder

modelName

public DashScopeRealtimeTTSModel.Builder modelName(String modelName)

Sets the TTS model name.

Supported models:

• qwen3-tts-flash-realtime - supports system voices
• qwen3-tts-vd-realtime - supports voice design via text description
• qwen3-tts-vc-realtime - supports voice cloning
• qwen-tts-realtime - legacy model

参数:

modelName - the model name

返回:

this builder

voice

public DashScopeRealtimeTTSModel.Builder voice(String voice)

Sets the voice for synthesis.

Available voices include: Cherry, Serena, Ethan, Chelsie, etc.

参数:

voice - the voice name

返回:

this builder

sampleRate

public DashScopeRealtimeTTSModel.Builder sampleRate(int sampleRate)

Sets the audio sample rate.

参数:

sampleRate - sample rate in Hz (default: 24000)

返回:

this builder

format

public DashScopeRealtimeTTSModel.Builder format(String format)

Sets the audio format.

Supported formats: pcm, mp3, opus

参数:

format - audio format

返回:

this builder

mode

public DashScopeRealtimeTTSModel.Builder mode(DashScopeRealtimeTTSModel.SessionMode mode)

Sets the session mode.

In DashScopeRealtimeTTSModel.SessionMode.SERVER_COMMIT mode, the server automatically commits text for synthesis. In DashScopeRealtimeTTSModel.SessionMode.COMMIT mode, the client must manually call DashScopeRealtimeTTSModel.commitTextBuffer().

参数:

mode - the session mode (default: SERVER_COMMIT)

返回:

this builder

languageType

public DashScopeRealtimeTTSModel.Builder languageType(String languageType)

Sets the language type for synthesis.

Supported values: Chinese, English, German, Italian, Portuguese, Spanish, Japanese, Korean, French, Russian, Auto

参数:

languageType - the language type (default: Auto)

返回:

this builder

build

public DashScopeRealtimeTTSModel build()

Builds the DashScopeRealtimeTTSModel instance.

返回:

a configured DashScopeRealtimeTTSModel

抛出:

IllegalArgumentException - if apiKey is not set