Struct TtsRequest 

pub struct TtsRequest {
    pub text: String,
    pub language: Option<String>,
    pub reference_audio: Option<AudioInput>,
    pub reference_text: Option<String>,
    pub voice: Option<VoiceCondition>,
    pub options: BTreeMap<String, Value>,
}

语音合成（TTS）的请求参数。

Fields

text: String

待合成文本。

language: Option<String>

文本语言（可选）。

reference_audio: Option<AudioInput>

说话人参考音频（声音克隆，如 Qwen3 TTS base 变体）。

reference_text: Option<String>

参考音频的文本转写（经 options.reference_text 交给上游）。

voice: Option<VoiceCondition>

说话人参考 / 风格条件（映射到上游 voice 字段）。

options: BTreeMap<String, Value>

附加选项键值（如流式 TTS 的 retry_badcase）。

Implementations

impl TtsRequest

pub fn new(text: impl Into<String>) -> Self

以待合成文本构造请求。

pub fn language(self, language: impl Into<String>) -> Self

设置文本语言。

pub fn reference(self, audio: impl Into<AudioInput>) -> Self

设置说话人参考音频（声音克隆）。

pub fn reference_text(self, text: impl Into<String>) -> Self

设置参考音频的文本转写。

pub fn voice(self, voice: VoiceCondition) -> Self

设置说话人参考 / 风格条件（映射到上游 voice 字段）。

例：Request::tts("Hi").voice(VoiceCondition::speaker("./ref.wav").emotion("happy"))。

pub fn option<V: Into<Value>>(self, key: impl Into<String>, value: V) -> Self

设置一个选项键值（等价于 JSON options 里的一个字段）。

pub fn options<K, V>(self, opts: impl IntoIterator<Item = (K, V)>) -> Self

where K: Into<String>, V: Into<Value>,

批量设置选项。

Trait Implementations

impl Clone for TtsRequest

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TtsRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.