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

# Guide de démarrage rapide de Text to Dialogue

Ce guide explique comment générer des dialogues immersifs au son naturel à partir de texte avec l’API Text to Dialogue.

> **Warning**
>
> 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 scripts plus longs en segments et assemblez l’audio côté client.

## Utiliser l’API Text to Dialogue

#### Créer une clé API

[Créez une clé API dans le Dashboard ici](https://elevenlabs.io/app/api/api-keys), que vous utiliserez pour [accéder à l’API](/docs/fr/api-reference/authentication) en toute sécurité.

Stockez la clé comme secret géré et transmettez-la aux SDK, soit sous forme de variable d’environnement via un fichier `.env`, soit directement dans la configuration de votre application, selon vos préférences.

**`.env`**

```js title=".env"
ELEVENLABS_API_KEY=<your_api_key_here>
```

#### Installer le SDK

#### SDK

Nous utiliserons également la bibliothèque `dotenv` pour charger notre clé API depuis une variable d'environnement.

```python
pip install elevenlabs
pip install python-dotenv
```

```typescript
npm install @elevenlabs/elevenlabs-js
npm install dotenv
```

#### CLI

Installez la CLI ElevenLabs. Homebrew (macOS) et Scoop (Windows) sont recommandés.

**`Homebrew (macOS)`**

```bash title="Homebrew (macOS)"
brew install elevenlabs/tap/elevenlabs
```

**`Scoop (Windows)`**

```powershell title="Scoop (Windows)"
scoop bucket add elevenlabs https://github.com/elevenlabs/scoop-bucket
scoop install elevenlabs
```

**`npm`**

```bash title="npm"
npm install -g @elevenlabs/cli
```

**`curl`**

```bash title="curl"
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | sh
```

> **Tip**
>
> Vous travaillez avec un assistant de programmation IA ? Exécutez `elevenlabs generate-skills` dans votre projet pour créer un
> fichier `SKILL.md` pour chaque groupe de commandes dans `skills/`, afin que votre assistant connaisse toutes les fonctionnalités de la CLI
> sans que vous ayez à copier la documentation. Utilisez `--output-dir` pour les placer ailleurs. Cette commande lit la propre
> définition d'API intégrée à la CLI, elle ne nécessite donc aucune clé API et fonctionne hors ligne, tout en restant synchronisée avec
> la version de la CLI que vous avez installée.

Authentifiez-vous ensuite, votre navigateur s'ouvrira pour autoriser la CLI :

```bash
elevenlabs auth login
```

#### Effectuer la requête API

#### SDK

Créez un fichier nommé `example.py` ou `example.mts`, selon le langage choisi, puis ajoutez le code suivant.
Ajoutez des balises audio dans chaque valeur `text` pour guider l’interprétation de ce locuteur. Le `voice_id`
sélectionne la voix du locuteur pour le même élément d’entrée.

```python focus={12-21} maxLines=0
# example.py
import os

from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
from elevenlabs.play import play

load_dotenv()

elevenlabs = ElevenLabs(
  api_key=os.getenv("ELEVENLABS_API_KEY"),
)

audio = elevenlabs.text_to_dialogue.convert(
    inputs=[
        {
            "text": "[cheerfully] Hello, how are you?",
            "voice_id": "9BWtsMINqrJLrRacOk9x",
        },
        {
            "text": "[stuttering] I'm... I'm doing well, thank you.",
            "voice_id": "IKne3meq5aSn9XLyUdCD",
        }
    ]
)

play(audio)
```

```typescript focus={7-17} maxLines=0
// example.mts
import { ElevenLabsClient, play } from "@elevenlabs/elevenlabs-js";
import "dotenv/config";

const elevenlabs = new ElevenLabsClient();

const audio = await elevenlabs.textToDialogue.convert({
    inputs: [
        {
            text: "[cheerfully] Hello, how are you?",
            voiceId: "9BWtsMINqrJLrRacOk9x",
        },
        {
            text: "[stuttering] I'm... I'm doing well, thank you.",
            voiceId: "IKne3meq5aSn9XLyUdCD",
        },
    ],
});

play(audio);
```

Exécutez ensuite le programme :

```python
python example.py
```

```typescript
npx tsx example.mts
```

Vous devriez entendre le dialogue audio.

#### CLI

Transmettez les entrées du dialogue sous la forme d’un tableau JSON et enregistrez l’audio dans un fichier :

```bash
elevenlabs text-to-dialogue convert \
  --output dialogue.mp3 \
  --inputs '[
    { "text": "[cheerfully] Hello, how are you?", "voice_id": "9BWtsMINqrJLrRacOk9x" },
    { "text": "[stuttering] I... I am doing well, thank you.", "voice_id": "IKne3meq5aSn9XLyUdCD" }
  ]'
```

Ouvrez `dialogue.mp3` pour entendre le résultat.

## Streaming WebSocket

Pour un dialogue incrémentiel via une connexion persistante avec les modèles **Eleven v3**, consultez [Text to Dialogue en temps réel](/docs/fr/eleven-api/guides/how-to/websockets/realtime-tdd). Pour comparer ce WebSocket au WebSocket TTS standard, consultez [WebSockets Text to Speech et Text to Dialogue](/docs/fr/eleven-api/guides/how-to/websockets/tts-vs-ttd-websockets).

## Étapes suivantes

#### [Parcourir les voix](https://elevenlabs.io/app/voice-library)

Explorez plus de 10 000 voix à attribuer à chaque locuteur du dialogue

#### [Text to Speech](/docs/fr/eleven-api/guides/cookbooks/text-to-speech)

Générez de la parole à partir d’une seule voix avec l’API Text to Speech

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

Explorez tous les paramètres et formats de réponse de Text to Dialogue