> 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.

# Text to Dialogue

## Vue d’ensemble

L’API ElevenLabs [Text to Dialogue](/docs/fr/api-reference/text-to-dialogue/convert) crée, à partir de texte, des dialogues expressifs au son naturel avec [Eleven v4](/docs/fr/overview/capabilities/text-to-speech/eleven-v4) et Eleven v3. Nous recommandons Eleven v4. Cas d’usage courants :

* Générer des conversations parfaitement justes pour les jeux vidéo
* Créer des dialogues immersifs pour les podcasts et d’autres contenus audio
* Donner vie aux livres audio grâce à une narration expressive

Plusieurs générations peuvent être nécessaires pour obtenir le résultat souhaité. Lors de l’intégration de Text to Dialogue à votre application, envisagez de générer plusieurs versions et de laisser l’utilisateur sélectionner la meilleure.

Pour placer la conversation dans une scène, par exemple un appel téléphonique, un café ou une grande salle, incluez [`audio_effects`](/docs/fr/api-reference/text-to-dialogue/convert#request.body.audio_effects) dans votre requête. Les mêmes préréglages de filtres, environnements et bruits de fond que pour les [effets audio de Text to Speech](/docs/fr/overview/capabilities/text-to-speech#audio-effects) s’appliquent à l’ensemble du dialogue. Les effets de dialogue sont disponibles uniquement via l’API.

Écoutez un exemple :

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

#### [Développeurs](/docs/fr/eleven-api/guides/cookbooks/text-to-dialogue)

Découvrez comment intégrer Text to Dialogue à votre application.

#### [Guide de prompting](/docs/fr/overview/capabilities/text-to-speech/best-practices#prompting-eleven-v4)

Découvrez comment guider un dialogue expressif à l’aide de balises audio.

#### [Guide de l’API](/docs/fr/api-reference/text-to-dialogue/convert)

Guide complet de l’API pour le point de terminaison Text to Dialogue.

## Options de voix

ElevenLabs propose des milliers de voix via plusieurs méthodes de création. Eleven v4 prend en charge plus de 90 langues et Eleven v3 plus de 70 langues.

* [Voice Library](/docs/fr/overview/capabilities/voices) avec plus de 10 000 voix partagées par la communauté
* [Clonage de voix professionnel](/docs/fr/overview/capabilities/voices#cloned) pour des répliques d’une fidélité maximale
* [Clonage de voix instantané](/docs/fr/overview/capabilities/voices#cloned) pour reproduire rapidement une voix
* [Conception de voix](/docs/fr/overview/capabilities/voices#voice-design) pour générer des voix personnalisées à partir de descriptions textuelles

En savoir plus sur nos [options de voix](/docs/fr/overview/capabilities/voices).

## Prompting

Les modèles interprètent directement le contexte émotionnel à partir du texte saisi. Par exemple, l’ajout de texte descriptif comme « elle a dit avec enthousiasme » ou l’utilisation de points d’exclamation influencera l’émotion de la parole. Les paramètres vocaux tels que la stabilité et la similarité permettent de contrôler la cohérence, tandis que l’émotion sous-jacente provient des indications textuelles.

Consultez le [guide de prompting](/docs/fr/overview/capabilities/text-to-speech/best-practices#prompting-eleven-v4) pour en savoir plus.

### Expressions émotionnelles avec des balises audio

> **Warning**
>
> Cette fonctionnalité est encore en développement actif. Les résultats peuvent varier.

Eleven v4 et Eleven v3 permettent d’utiliser des événements audio non vocaux pour influencer l’interprétation du dialogue. Pour cela, insérez les événements audio entre crochets dans le texte saisi.

Dans Text to Dialogue, chaque tour de dialogue possède son propre texte et sa propre voix. Ajoutez des balises audio au texte du tour qu’elles doivent affecter. `voice_id` sélectionne toujours la voix du locuteur pour ce tour, tandis que les balises guident l’interprétation.

Par exemple, un locuteur peut utiliser une voix tandis que le texte commence par `[giggling]`, puis le locuteur suivant peut utiliser une autre voix tandis que le texte commence par `[whispering]`. Pour un exemple d’API combinant des balises avec `voice_id`, consultez le [guide de démarrage rapide Text to Dialogue](/docs/fr/eleven-api/guides/cookbooks/text-to-dialogue).

Les balises audio sont des instructions en langage naturel, pas un paramètre d’énumération. Placez l’instruction entre crochets dans le texte à l’endroit où l’interprétation doit changer. Les exemples ci-dessous ne sont pas exhaustifs. Consultez le [guide de prompting](/docs/fr/overview/capabilities/text-to-speech/best-practices#prompting-eleven-v4) pour obtenir davantage de conseils sur les balises efficaces.

Les balises audio prennent plusieurs formes :

### Émotions et interprétation

Par exemple, \[sad], \[laughing] et \[whispering]

### Événements audio

Par exemple, \[leaves rustling], \[gentle footsteps] et \[applause].

### Indication générale

Par exemple, \[football], \[wrestling match] et \[auctioneer].

Voici quelques exemples :

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

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

Vous pouvez également utiliser la ponctuation pour indiquer le déroulement du dialogue, notamment les interruptions :

```
"[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" />

Les points de suspension peuvent indiquer des phrases laissées en suspens :

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

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

#### Formats de sortie pris en charge

Le format de réponse par défaut est `mp3`, mais d’autres formats comme `pcm` et `ulaw` sont disponibles.

* **MP3**
  * Fréquences d’échantillonnage : 22,05 kHz - 44,1 kHz
  * Débits binaires : 32 kbps - 192 kbps
  * 22,05 kHz à 32 kbps
  * 44,1 kHz à 32 kbps, 64 kbps, 96 kbps, 128 kbps, 192 kbps
* **PCM (S16LE)**
  * Fréquences d’échantillonnage : 16 kHz - 44,1 kHz
  * Débits binaires : 8 kHz, 16 kHz, 22,05 kHz, 24 kHz, 44,1 kHz, 48 kHz
  * Profondeur de 16 bits
* **μ-law**
  * Fréquence d’échantillonnage de 8 kHz
  * Optimisé pour les applications de téléphonie
* **A-law**
  * Fréquence d’échantillonnage de 8 kHz
  * Optimisé pour les applications de téléphonie
* **Opus**
  * Fréquence d’échantillonnage : 48 kHz
  * Débits binaires : 32 kbps - 192 kbps

> **Success**
>
> Les options audio de qualité supérieure sont disponibles uniquement avec les forfaits payants. Consultez notre [page des tarifs ](https://elevenlabs.io/pricing/api) pour en savoir plus.

## Langues prises en charge

Eleven v4 prend en charge plus de 90 langues. Eleven v3 prend en charge plus de 70 langues. Consultez [Eleven v4](/docs/fr/overview/models#eleven-v4) et [Eleven v3](/docs/fr/overview/models#eleven-v3) pour obtenir les listes complètes.

## FAQ

#### Quels modèles puis-je utiliser ?

Text to Dialogue est disponible avec les modèles Eleven v4 et Eleven v3.

#### Suis-je propriétaire de la sortie audio ?

Oui. Vous restez propriétaire de tout audio que vous générez. Toutefois, les droits d’utilisation commerciale sont uniquement disponibles avec les forfaits payants. Avec un abonnement payant, vous pouvez utiliser l’audio généré à des fins commerciales et monétiser les résultats si vous détenez les droits de propriété intellectuelle du contenu source.

#### Qu’est-ce qui donne droit à une régénération gratuite ?

Une régénération gratuite vous permet de régénérer le même contenu de synthèse vocale sans frais supplémentaires, sous réserve des conditions suivantes :

* Disponible uniquement dans le Dashboard ElevenLabs.
* Vous pouvez régénérer chaque contenu gratuitement jusqu’à 2 fois.
* Le contenu doit être exactement identique à celui de la génération précédente. Toute modification du texte, des paramètres vocaux ou d’autres paramètres nécessitera une nouvelle génération payante.

Les régénérations gratuites sont utiles en cas de légère distorsion dans la sortie audio. Selon les benchmarks internes d’ElevenLabs, les régénérations résolvent environ la moitié des problèmes de qualité, les problèmes restants étant généralement dus à des données d’entraînement de mauvaise qualité.

#### Combien de locuteurs mon dialogue peut-il comporter ?

Le nombre de locuteurs dans un dialogue n’est pas limité.

#### Pourquoi ma sortie est-elle parfois incohérente ?

Les modèles sont non déterministes. Pour plus de cohérence, utilisez le [paramètre seed ](/docs/fr/api-reference/text-to-speech/convert#request.body.seed) facultatif, bien que de légères différences puissent subsister.

#### Quelle est la meilleure pratique pour les conversions de texte volumineux ?

Pour une génération fiable, maintenez la longueur totale de toutes les valeurs `inputs[].text` à 2 000 caractères ou moins par requête. Divisez les textes plus longs en segments et concaténez l’audio obtenu dans votre application.

## Points clés

* **Modèles** : disponible avec Eleven v4 et Eleven v3
* **Locuteurs** : aucun plafond du nombre de locuteurs par dialogue
* **Taille des requêtes** : maintenez la longueur totale de toutes les valeurs `inputs[].text` à 2 000 caractères ou moins par requête
* **Déterminisme** : la sortie est non déterministe, utilisez le paramètre `seed` pour des résultats plus cohérents
* **Régénérations gratuites** : jusqu’à 2 régénérations gratuites par génération, uniquement pour le même contenu et les mêmes paramètres, dans le Dashboard
* **Propriété** : vous restez propriétaire de l’audio généré ; l’utilisation commerciale exige un forfait payant