Skip to navigation
Tutorials

Text to Dialogue-quickstart

Leer hoe je meeslepende dialogen uit tekst genereert.

In deze handleiding lees je hoe je met de Text to Dialogue API meeslepende, natuurlijk klinkende dialogen uit tekst genereert.

Houd de totale lengte van alle waarden van inputs[].text per request op maximaal 2.000 tekens voor betrouwbare generatie. Splits langere scripts op in delen en voeg de audio aan de clientzijde samen.

De Text to Dialogue API gebruiken

1

Een API-sleutel maken

Maak hier een API-sleutel in het dashboard, die je gebruikt voor veilige toegang tot de API.

Sla de sleutel op als beheerd geheim en geef deze aan de SDK’s door als omgevingsvariabele via een .env-bestand, of rechtstreeks in de configuratie van je app, afhankelijk van je voorkeur.

.env
ELEVENLABS_API_KEY=<your_api_key_here>
2

De SDK installeren

We gebruiken ook de dotenv-bibliotheek om onze API-sleutel uit een omgevingsvariabele te laden.

pip install elevenlabs
pip install python-dotenv
3

De API-request doen

Maak een nieuw bestand met de naam example.py of example.mts, afhankelijk van de taal die je kiest, en voeg de volgende code toe. Voeg audiotags toe in elke text-waarde om de voordracht van die spreker te sturen. De voice_id selecteert de sprekersstem voor hetzelfde invoeritem.

# 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)

Voer deze vervolgens uit:

python example.py

Je zou de dialoogaudio moeten horen afspelen.

WebSocket-streaming

Volg voor incrementele dialoog via een langdurige verbinding met Eleven v3-modellen Realtime Text to Dialogue. Bekijk Text to Speech vs Text to Dialogue WebSockets om deze WebSocket te vergelijken met de standaard TTS-WebSocket.

Volgende stappen

Stemmen bekijken

Verken meer dan 10.000 stemmen om aan elke dialoogspreker toe te wijzen

Text to Speech

Genereer spraak met één stem via de Text to Speech API

API-referentie

Bekijk alle Text to Dialogue-parameters en responseformaten