model | str | はい | モデル名です。 |
voice | str | はい | 音声合成に使用する音声。
- システム音声: 「Qwen-Audio-TTS 音声リスト」をご参照ください。
- クローン音声: 音声クローニングによって作成されたカスタム音声
- カスタム音声: 音声デザインによって作成されたカスタム音声
|
format | str | いいえ | 音声のエンコードフォーマットです。デフォルト値:mp3。mp3、wav、pcm などのフォーマットをサポートします。サンプリングレートは sample_rate パラメーターで設定し、デフォルト値は 22050 です。 |
volume | int | いいえ | 音量です。デフォルト値:50。有効な値:[0, 100]。 |
rate | float | いいえ | 話速です。デフォルト値:1.0。有効な値:[0.5, 2.0]。 |
pitch | float | いいえ | ピッチです。デフォルト値:1.0。有効な値:[0.5, 2.0]。 |
bit_rate | int | いいえ | 音声のビットレート (kbps) です。音声フォーマットが mp3 または opus の場合、bit_rate でビットレートを調整します。デフォルト値:32。有効な値:[6, 510]。bit_rate は parameters 辞書で設定します:audio = client.audio.tts.synthesize(
"Text to synthesize",
model="qwen-audio-3.0-tts-flash",
voice="longanhuan_v3.6",
parameters={"bit_rate": 128},
)
|
word_timestamp_enabled | bool | いいえ | 単語レベルのタイムスタンプを有効にするかどうかを指定します。デフォルト値:false。ストリーミング出力モードでのみ利用可能です。クローン音声がサポートされています。対応するシステム音声については、「Qwen-Audio-TTS 音声リスト」をご参照ください。word_timestamp_enabled は parameters 辞書で設定します:audio = client.audio.tts.stream(
"Text to synthesize",
model="qwen-audio-3.0-tts-flash",
voice="your_voice", # 単語レベルのタイムスタンプをサポートするシステム音声またはクローン音声
parameters={"word_timestamp_enabled": True},
)
|
seed | int | いいえ | 合成結果の変動を制御するためのランダムシードです。モデルのバージョン、テキスト、音声、その他のパラメーターが変わらない場合、同じシードを使用すると同一の結果が得られます。デフォルト値:0。有効な値:[0, 65535]。 |
language_hints | list[str] | いいえ |
- このパラメーターは配列ですが、現在のバージョンでは最初の要素のみが処理されます。単一の値を渡してください。
- このパラメーターは音声合成のターゲット言語を指定します。これは、音声クローニングで使用される音声サンプルの言語とは無関係です。クローニングタスクのソース言語を設定するには、音声クローニング API リファレンスをご参照ください。
出力品質を向上させるために、音声合成のターゲット言語を指定します。数字の発音、略語の展開、記号の読み上げ、または少数言語の合成が期待どおりでない場合に、このパラメーターを使用します。例:
- 予期しない数字の発音:「hello, this is 110」が、期待される中国語の発音ではなく「hello, this is one zero」と読まれる場合
- 不正確な記号の発音:「@」が「at」ではなく、中国語の同等語で読まれる場合
- 少数言語の合成品質が低く、不自然な結果になる場合
-
zh:中国語
-
en:英語
-
fr:フランス語
-
de:ドイツ語
-
ja:日本語
-
ko:韓国語
-
ru:ロシア語
-
pt:ポルトガル語
-
th:タイ語
-
id:インドネシア語
-
vi:ベトナム語
-
es:スペイン語
-
it:イタリア語
-
ms:マレーシア語
-
fil:フィリピン語
-
ar:アラビア語
-
other:その他の言語(
qwen-audio-3.1-tts-flash でサポート)
ブルガリア語、オランダ語、ハンガリー語、ルーマニア語、デンマーク語、クロアチア語、ギリシャ語、チェコ語、ノルウェー語、スウェーデン語、ヒンディー語、スロバキア語、フィンランド語、ウルドゥー語、セルビア語、スペイン語 (メキシコ)、リトアニア語、ラトビア語、トルコ語、ペルシア語、ヘブライ語、モンゴル語、スロベニア語、アゼルバイジャン語、ポーランド語、カタロニア語、クメール語、ポルトガル語 (ブラジル)、ラオ語、ジョージア語、アフリカーンス語、ネパール語、ベラルーシ語、マラヤーラム語、ルクセンブルク語、アルバニア語、タミル語、シンハラ語、テルグ語、エストニア語、セブアノ語、ボスニア語、ミャンマー語、アルメニア語、ラテン語、アイスランド語、マルタ語、スワヒリ語、カザフ語、セーシェル・クレオール語、ウクライナ語。
|
instruction | str | いいえ | 方言、感情、話し方のスタイルなど、合成の特性を制御します。使用方法の詳細については、「指示コントロール」をご参照ください。 |
enable_aigc_tag | bool | いいえ | 生成された音声に AIGC ウォーターマークを埋め込むかどうかを指定します。true に設定すると、対応するフォーマット (wav/mp3/opus) の音声ファイルにウォーターマークが埋め込まれます。デフォルト値:false。enable_aigc_tag、aigc_propagator、aigc_propagate_id は parameters 辞書で設定します:audio = client.audio.tts.synthesize(
"Text to synthesize",
model="qwen-audio-3.0-tts-flash",
voice="longanhuan_v3.6",
parameters={
"enable_aigc_tag": True,
"aigc_propagator": "your_propagator",
"aigc_propagate_id": "your_propagate_id"
},
)
|
aigc_propagator | str | いいえ | AIGC ウォーターマークの ContentPropagator フィールドを設定し、コンテンツの伝播者を識別します。enable_aigc_tag が true の場合にのみ有効になります。デフォルト値:Alibaba Cloud の UID。parameters 辞書で設定します。設定例については enable_aigc_tag をご参照ください。 |
aigc_propagate_id | str | いいえ | AIGC ウォーターマークの PropagateID フィールドを設定し、特定の伝播アクションを一意に識別します。enable_aigc_tag が true の場合にのみ有効になります。デフォルト値:現在の音声合成リクエストのリクエスト ID。parameters 辞書で設定します。設定例については enable_aigc_tag をご参照ください。 |
hot_fix | dict | いいえ | 合成前に適用される発音修正とテキスト置換を設定します。パラメーター:
- pronunciation:カスタム発音。単語に拼音注釈を指定し、デフォルトの発音が不正確な場合に修正します。
- replace:テキスト置換。合成前に特定の単語をターゲットテキストに置き換えます。置換後のテキストが合成の実際の入力として使用されます。
設定例:audio = client.audio.tts.synthesize(
"Text to synthesize",
model="qwen-audio-3.0-tts-flash",
voice="your_voice_id", # 音声
parameters={
"hot_fix": {
"pronunciation": [{"weather": "tian1 qi4"}],
"replace": [{"today": "gold day"}]
}
},
)
|