> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# テキストtoダイアログ

## 概要

ElevenLabsの[テキストtoダイアログ](/docs/ja/api-reference/text-to-dialogue/convert)APIは、[Eleven v4](/docs/ja/overview/capabilities/text-to-speech/eleven-v4)とEleven v3を使用して、テキストから自然で表現力豊かな対話を作成します。Eleven v4を推奨します。主なユースケースは次のとおりです。

* ビデオゲーム向けの完璧な会話を生成
* ポッドキャストなどのオーディオコンテンツ向けに没入感のある対話を作成
* 表現力豊かなナレーションでオーディオブックに命を吹き込む

望ましい結果を得るために、複数回の生成が必要になることがあります。テキストtoダイアログをアプリケーションに統合する際は、複数の生成を行い、ユーザーが最適なものを選べるようにしてください。

電話、カフェ、大きなホールなどのシーンに対話を配置するには、リクエストで[`audio_effects`](/docs/ja/api-reference/text-to-dialogue/convert#request.body.audio_effects)を渡します。[テキスト読み上げのオーディオエフェクト](/docs/ja/overview/capabilities/text-to-speech#audio-effects)と同じフィルタープリセット、環境、バックグラウンドノイズが対話全体に適用されます。対話エフェクトはAPI経由でのみ利用できます。

サンプルをお聞きください。

<elevenlabs-audio-player audio-title="Dialogue example" audio-src="https://storage.googleapis.com/eleven-public-cdn/documentation_assets/audio/dialogue.mp3" />

#### [デベロッパー](/docs/ja/eleven-api/guides/cookbooks/text-to-dialogue)

アプリケーションにテキストtoダイアログを統合する方法を学びます。

#### [プロンプトガイド](/docs/ja/overview/capabilities/text-to-speech/best-practices#prompting-eleven-v4)

オーディオタグを使って表現力豊かな対話をプロンプトする方法を学びます。

#### [APIリファレンス](/docs/ja/api-reference/text-to-dialogue/convert)

テキストtoダイアログエンドポイントの完全なAPIリファレンスです。

## 音声オプション

ElevenLabsは、複数の作成方法を通じて数千種類の音声を提供しています。Eleven v4は90以上の言語、Eleven v3は70以上の言語に対応しています。

* コミュニティが共有した3,000以上の音声を収録した[ボイスライブラリ](/docs/ja/overview/capabilities/voices)
* 最高忠実度の複製を実現する[プロフェッショナルボイスクローン](/docs/ja/overview/capabilities/voices#cloned)
* 素早く音声を複製する[インスタントボイスクローン](/docs/ja/overview/capabilities/voices#cloned)
* テキストによる説明からカスタム音声を生成する[ボイスデザイン](/docs/ja/overview/capabilities/voices#voice-design)

[音声オプション](/docs/ja/overview/capabilities/voices)の詳細をご覧ください。

## プロンプト

モデルは、テキスト入力から感情的なコンテキストを直接解釈します。たとえば、
「彼女は興奮して言った」のような説明文を追加したり、感嘆符を使用したりすると、発話の
感情に影響します。StabilityやSimilarityなどの音声設定は一貫性の制御に役立ちますが、
基になる感情はテキストの手がかりから得られます。

詳しくは[プロンプトガイド](/docs/ja/overview/capabilities/text-to-speech/best-practices#prompting-eleven-v4)をお読みください。

### オーディオタグによる感情表現

> **Warning**
>
> この機能は現在も活発に開発中のため、実際の結果は異なる場合があります。

Eleven v4とEleven v3では、非音声のオーディオイベントを使用して対話の話し方に影響を与えることができます。これは、角括弧で囲んだオーディオイベントをテキスト入力に挿入して行います。

テキストtoダイアログでは、各対話ターンにそれぞれテキストと音声があります。影響を与えたいターンのテキスト内にオーディオタグを追加します。`voice_id`は引き続きそのターンの話者音声を選択し、タグは話し方を指定します。

たとえば、話者はテキストを`[giggling]`で始めながら1つの音声を使用でき、次の話者はテキストを`[whispering]`で始めながら別の音声を使用できます。タグと`voice_id`を組み合わせたAPI例については、[テキストtoダイアログのクイックスタート](/docs/ja/eleven-api/guides/cookbooks/text-to-dialogue)をご覧ください。

オーディオタグはenumパラメーターではなく、自然言語による指示です。指示を角括弧で囲み、話し方を変えたい位置のテキストに配置します。以下の例は網羅的なものではありません。効果的なタグに関する詳しいガイダンスは、[プロンプトガイド](/docs/ja/overview/capabilities/text-to-speech/best-practices#prompting-eleven-v4)をご覧ください。

オーディオタグにはいくつかの形式があります。

### 感情と話し方

たとえば、\[sad]、\[laughing]、\[whispering]

### オーディオイベント

たとえば、\[leaves rustling]、\[gentle footsteps]、\[applause]。

### 全体的な演出

たとえば、\[football]、\[wrestling match]、\[auctioneer]。

例をいくつか紹介します。

```
"[giggling] That's really funny!"
"[groaning] That was awful."
"Well, [sigh] I'm not sure what to say."
```

<elevenlabs-audio-player audio-title="Expressive dialogue" audio-src="https://storage.googleapis.com/eleven-public-cdn/documentation_assets/audio/dialogue-emotive.mp3" />

割り込みなどの対話の流れを示すために、句読点を使用することもできます。

```
"[cautiously] Hello, is this seat-"
"[jumping in] Free? [cheerfully] Yes it is."
```

<elevenlabs-audio-player audio-title="Interruption" audio-src="https://storage.googleapis.com/eleven-public-cdn/documentation_assets/audio/dialogue-interruption.mp3" />

文が続くことを示すには、省略記号を使用できます。

```
"[indecisive] Hi, can I get uhhh..."
"[quizzically] The usual?"
"[elated] Yes! [laughs] I'm so glad you knew!"
```

<elevenlabs-audio-player audio-title="Ellipses" audio-src="https://storage.googleapis.com/eleven-public-cdn/documentation_assets/audio/dialogue-ellipses.mp3" />

#### 対応出力形式

デフォルトのレスポンス形式は`mp3`ですが、`pcm`や`ulaw`などの形式も利用できます。

* **MP3**
  * サンプルレート：22.05kHz～44.1kHz
  * ビットレート：32kbps～192kbps
  * 22.05kHz @ 32kbps
  * 44.1kHz @ 32kbps、64kbps、96kbps、128kbps、192kbps
* **PCM（S16LE）**
  * サンプルレート：16kHz～44.1kHz
  * ビットレート：8kHz、16kHz、22.05kHz、24kHz、44.1kHz、48kHz
  * 16ビット深度
* **μ-law**
  * 8kHzサンプルレート
  * 電話アプリケーション向けに最適化
* **A-law**
  * 8kHzサンプルレート
  * 電話アプリケーション向けに最適化
* **Opus**
  * サンプルレート：48kHz
  * ビットレート：32kbps～192kbps

> **Success**
>
> 高品質なオーディオオプションは有料プランでのみ利用できます。詳しくは[料金 ページ](https://elevenlabs.io/pricing/api)をご覧ください。

## 対応言語

Eleven v4は90以上の言語に対応しています。Eleven v3は70以上の言語に対応しています。完全なリストは[Eleven v4](/docs/ja/overview/models#eleven-v4)と[Eleven v3](/docs/ja/overview/models#eleven-v3)をご覧ください。

## よくある質問

#### どのモデルを使用できますか？

テキストtoダイアログは、Eleven v4およびEleven v3モデルで利用できます。

#### オーディオ出力の所有権は自分にありますか？

はい。生成したオーディオの所有権は保持されます。ただし、商用利用権は有料プランでのみ
利用できます。有料サブスクリプションでは、入力コンテンツのIP権利を所有している場合、生成したオーディオを商用目的で使用し、出力を収益化
できます。

#### 無料の再生成の対象となる条件は？

無料再生成では、次の条件に従い、追加料金なしで同じテキスト読み上げコンテンツを再生成できます。

* ElevenLabsダッシュボード内でのみ利用できます。
* 各コンテンツは最大2回まで無料で再生成できます。
* コンテンツは前回の生成と完全に同じである必要があります。テキスト、音声設定、その他のパラメーターを変更すると、新たに有料の生成が必要になります。

無料再生成は、オーディオ出力にわずかな歪みがある場合に役立ちます。ElevenLabsの社内ベンチマークによると、再生成により品質に関する問題のおよそ半分が解決され、残りの問題は通常、トレーニングデータの品質不良によるものです。

#### 対話には何人の話者を含められますか？

対話の話者数に制限はありません。

#### 出力に一貫性がないことがあるのはなぜですか？

モデルは非決定的です。一貫性を高めるには、任意の[seed パラメーター](/docs/ja/api-reference/text-to-speech/convert#request.body.seed)を使用してください。ただし、わずかな
差異が生じる場合があります。

#### 長いテキストを変換する場合のベストプラクティスは？

信頼性の高い生成のため、リクエストごとにすべての`inputs[].text`値の合計長を2,000文字以下にしてください。長いテキストはチャンクに分割し、アプリケーションで生成されたオーディオを連結してください。

## 主な仕様

* **モデル**：Eleven v4およびEleven v3で利用可能
* **話者**：1つの対話あたりの話者数に制限なし
* **リクエストサイズ**：リクエストごとにすべての`inputs[].text`値の合計長を2,000文字以下にしてください
* **決定性**：出力は非決定的です。一貫性のある結果を得るには`seed`パラメーターを使用してください
* **無料再生成**：生成ごとに最大2回の無料再生成（同じコンテンツ、同じパラメーター、ダッシュボードのみ）
* **所有権**：生成したオーディオの所有権は保持されます。商用利用には有料プランが必要です