Skip to navigation
Praktische handleidingenStemmen

Snelstartgids voor Voice Design

In deze handleiding leer je hoe je via een tekstprompt een stem ontwerpt met de Voice Design API.

In deze handleiding leer je hoe je via een prompt een stem ontwerpt met de Voice Design API.

De Voice Design API gebruiken

Deze handleiding gaat ervan uit dat je je API-sleutel en SDK hebt ingesteld. Voltooi eerst de snelstartgids als je dat nog niet hebt gedaan. Mogelijk heb je ook MPV en/of ffmpeg nodig om audio via je speakers af te spelen.

1

De API-request uitvoeren

Een stem ontwerpen via een prompt bestaat uit twee stappen:

  1. Genereer previews op basis van een prompt.
  2. Selecteer de beste preview en gebruik deze om een nieuwe stem te maken.

We beginnen met het genereren van previews op basis van een prompt.

Maak een nieuw bestand met de naam example.py of example.mts, afhankelijk van de programmeertaal van je keuze, en voeg de volgende code toe:

# example.py
from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
from elevenlabs.play import play
import base64
load_dotenv()
elevenlabs = ElevenLabs(
  api_key=os.getenv("ELEVENLABS_API_KEY"),
)
voices = elevenlabs.text_to_voice.design(
    model_id="eleven_multilingual_ttv_v2",
    voice_description="A massive evil ogre speaking at a quick pace. He has a silly and resonant tone.",
    text="Your weapons are but toothpicks to me. Surrender now and I may grant you a swift end. I've toppled kingdoms and devoured armies. What hope do you have against me?",
)
for preview in voices.previews:
    # Convert base64 to audio buffer
    audio_buffer = base64.b64decode(preview.audio_base_64)
    print(f"Playing preview: {preview.generated_voice_id}")
    play(audio_buffer)
2

De code uitvoeren

python example.py

Je zou de gegenereerde stempreviews één voor één via je speakers moeten horen.

3

Gegenereerde stem aan je bibliotheek toevoegen

Nadat je de previews hebt gegenereerd en je favoriet hebt gekozen, kun je deze via de gegenereerde stem-ID aan je stembibliotheek toevoegen, zodat je deze met andere API’s kunt gebruiken.

voice = elevenlabs.text_to_voice.create(
    voice_name="Jolly giant",
    voice_description="A huge giant, at least as tall as a building. A deep booming voice, loud and jolly.",
    # The generated voice ID of the preview you want to use,
    # using the first in the list for this example
    generated_voice_id=voices.previews[0].generated_voice_id
)
print(voice.voice_id)

Volgende stappen

Instant voice cloning

Kloon een stem op basis van bestaande audio in plaats van er een uit een beschrijving te genereren.

API-referentie

Volledige Voice Design API-referentie en parameters.