このトピックでは、DashScope Java SDK を使用して Qwen-TTS-Realtime シリーズのモデルを呼び出す際の、主要なインターフェースとリクエストパラメーターを説明します。
前提条件
DashScope Java SDK 2.22.7 以降が必要です。
クイックスタート
- サーバーコミットモード
- コミットモード
appendText()リクエストパラメーター
QwenTtsRealtimeParam オブジェクトのメソッドチェーンまたはセッターを使用して以下のリクエストパラメーターを設定し、そのオブジェクトを QwenTtsRealtime コンストラクターに渡します。
パラメーター | タイプ | 必須 | 説明 |
|---|---|---|---|
model | 文字列 | はい | モデル名 (「サポートされているモデル」をご参照ください)。 |
url | 文字列 | はい | China (Beijing): Singapore: |
QwenTtsRealtimeConfig オブジェクトのメソッドチェーンまたはセッターを使用して以下のリクエストパラメーターを設定し、そのオブジェクトを updateSession メソッドに渡します。
パラメーター | タイプ | 必須 | 説明 |
|---|---|---|---|
voice | 文字列 | はい | 音声合成に使用する音声です。詳細については、「Qwen-TTS ボイスリスト」をご参照ください。 |
languageType | 文字列 | いいえ | 合成オーディオの言語です。デフォルト値は
|
mode | 文字列 | いいえ | インタラクションパターンです。有効な値は以下のとおりです。
|
format | 文字列 | いいえ | モデルからのオーディオ出力フォーマットです。 サポートされるフォーマット:
|
sampleRate | int | いいえ | モデルからのオーディオ出力のサンプルレート (Hz) です。 サポートされるサンプルレート:
|
speechRate | float | いいえ | オーディオの話速です。1.0 が通常速度です。1.0 未満は低速、1.0 より大きい値は高速になります。 デフォルト値:1.0 有効範囲:[0.5, 2.0] |
volume | int | いいえ | オーディオのボリュームです。 有効範囲:[0, 100] |
pitchRate | float | いいえ | 合成オーディオのピッチです。 デフォルト値:1.0 有効範囲:[0.5, 2.0] |
bitRate | int | いいえ | ビットレート (kbps) です。ビットレートが高いほどオーディオ品質が向上し、ファイルサイズも大きくなります。このパラメーターは、オーディオフォーマット ( デフォルト値:128 有効範囲:[6, 510] |
主要なインターフェイス
QwenTtsRealtime クラス
インポート:
| メソッド | シグネチャ | サーバー イベント | 説明 |
|---|---|---|---|
| connect | session.createdセッションが作成されましたsession.updated セッション設定が更新されました | サーバーへの WebSocket 接続を開きます。 | |
| updateSession | session.updatedセッション設定が更新されました | セッション設定を更新します。リクエストパラメーターをご参照ください。接続後、サーバーはセッションのデフォルトの入力および出力設定を返します。デフォルト値をオーバーライドするには、connect() の直後にこのメソッドを呼び出してください。サーバーは、session.update イベントを受信するとパラメーターを検証します。パラメーターが無効な場合、サーバーはエラーを返します。それ以外の場合は、サーバーサイドでセッション設定を更新します。 | |
| appendText | なし | テキストセグメントをサーバーサイドの入力バッファーに追加します。バッファーは、コミットされるまでテキストを保持します。
| |
| clearAppendedText | input_text_buffer.clearedサーバーが受信したテキストがクリアされました | サーバーサイドの入力バッファー内のすべてのテキストをクリアします。 | |
| commit | input_text_buffer.committedテキストがコミットされ、音声合成がトリガーされましたresponse.output_item.added 応答に新しい出力コンテンツが表示されましたresponse.content_part.added アシスタントメッセージアイテムに新しい出力コンテンツが追加されましたresponse.audio.delta モデルがオーディオを段階的に生成しましたresponse.audio.done オーディオ生成が完了しましたresponse.content_part.done アシスタントメッセージのオーディオコンテンツのストリーミングが完了しましたresponse.output_item.done アシスタントメッセージの出力アイテム全体のストリーミングが完了しましたresponse.done 応答が完了しました | 以前にサーバーサイドのバッファーに追加されたテキストをコミットし、すべてのテキストを直ちに合成します。バッファーが空の場合はエラーを返します。
| |
| finish | session.finishedセッションが終了しました | 現在のタスクを停止します。 | |
| close | なし | 接続を閉じます。 | |
| getSessionId | なし | 現在のタスクのセッション ID を返します。 | |
| getResponseId | なし | 最新の応答のレスポンス ID を返します。 | |
| getFirstAudioDelay | なし | 最初のオーディオパケットのレイテンシーをミリ秒単位で返します。 |
コールバックインターフェイス (QwenTtsRealtimeCallback)
| メソッド | パラメーター | 戻り値 | 説明 |
|---|---|---|---|
| なし | なし | WebSocket 接続が確立された直後に呼び出されます。 | |
| message:サーバーサイドの応答イベント。 | なし | サーバーがイベントを送信したときに呼び出されます。API 呼び出しの応答やモデルが生成したオーディオが含まれます。「サーバーサイド イベント」をご参照ください。 | |
| code:WebSocket 終了ステータスコード。reason:終了理由。 | なし | サーバーが接続を閉じた後に呼び出されます。 |