Text to Speech integreren in je applicaties

Om Text to Speech in je applicaties te integreren, maak je een API-sleutel, installeer je de ElevenLabs SDK, stuur je tekst met een stem en een model naar het TTS-endpoint en speel je de audio af die je terugkrijgt.

Deze handleiding behandelt elk van die stappen in Python en TypeScript, laat zien hoe je de beste TTS-integratiemethode voor jou kiest en biedt oplossingen voor veelvoorkomende fouten.

Wat is een Text to Speech API?

Met een Text to Speech API kunnen ontwikkelaars geschreven tekst programmatisch omzetten in natuurlijk klinkende audio, zonder zelf een TTS-model te hoeven hosten. Na het integreren van een TTS API in een applicatie hoeven ontwikkelaars alleen een request naar de API te sturen en de audio terug te ontvangen, zodat ze eenvoudig een spraaklaag aan applicaties toevoegen.

De beste Text to Speech API's, zoals die van ElevenAPI, bieden gedetailleerde controle over hoe de uiteindelijke audio klinkt: van de keuze van de stem die een tekstsegment uitspreekt tot de emotie die deze overbrengt. Afhankelijk van de toepassing van je applicatie kun je ook kiezen tussen batch- en streamingverwerkingsopties om je audiofragmenten te maken.

Zo werkt een request naar een Text to Speech API

Wanneer je een TTS API aanroept, vinden er achter de schermen enkele stappen plaats om je audio te leveren.

Zo werkt een request naar een Text to Speech API:

1. Je applicatie stuurt de tekst samen met de door jou gekozen stem en het model naar het Text to Speech-endpoint. 
2. De API genereert de spraak en stuurt audio terug in het door jou aangevraagde uitvoerformaat, zoals MP3.
3. Je applicatie speelt de audio af of slaat deze op als bestand. 

Een extra aandachtspunt: als je applicatie in een browser draait, stuur je het request via je eigen server, zodat je API-sleutel nooit in client-side code verschijnt.

Een checklist van wat je nodig hebt voordat je TTS in je applicaties integreert

Voordat je Text to Speech in je applicaties integreert, moet je eerst controleren of je het volgende hebt:

• Een ElevenLabs-account. Je kunt je registreren in enkele minuten. 
• Een terminal en een code-editor.
• Python 3 of Node.js geïnstalleerd op de computer waarop je werkt.
• Een manier om de audio die je ontvangt af te spelen.

Als je dit allemaal hebt, kun je TTS in je app bouwen.

Text to Speech integreren in je applicatie

Met ElevenAPI kost het integreren van een TTS API in je applicatie maar een paar minuten. Als je al een account hebt, kun je direct naar de onderstaande stappen gaan. Zo niet, vergeet dan niet je te registreren om aan de slag te gaan.

De stappen zijn als volgt:

1. Maak een API-sleutel
2. Installeer de SDK
3. Doe je eerste request
4. Voer het uit

Laten we deze stappen uitgebreider bekijken.

Maak een API-sleutel

Haal een API-sleutel op in het ElevenLabs API-dashboard. Nadat je op ‘Create Key’ hebt geklikt, kun je het type API configureren dat je wilt instellen. Zorg er voor deze toepassing voor dat TTS is ingeschakeld met 'Access'.

Kopieer de API-sleutel en plak deze als omgevingsvariabele in .env (of rechtstreeks in de configuratie van je app, afhankelijk van de architectuur). Opslag in je .env-bestand is een effectieve manier om je sleutel geheim te houden, terwijl je script deze tijdens runtime kan laden.

ELEVENLABS_API_KEY=<your_api_key_here>

Laat je de installatie liever door je coding agent uitvoeren? Plak dit in je agent: npx -y @elevenlabs/cli@latest onboard init. De ElevenLabs CLI opent je browser zodat je kunt inloggen, slaat de sleutel op in het env-bestand van je project en begeleidt de agent door de overige stappen. Voor npx heb je Node.js nodig. Bekijk de quickstart voor meer informatie.

Installeer de SDK

Bij het instellen van een Text to Speech API moet je twee hoofdpakketten installeren. Het eerste is de ElevenLabs SDK, die de API-aanroep voor je afhandelt. Het tweede is dotenv, dat je API-sleutel laadt vanuit het .env-bestand dat je in stap 1 hebt geconfigureerd.

Werk je in de CLI? Raadpleeg dan onze TTS API-documentatie, waar je specifiekere instructies en beschikbare opties vindt. 

Zo installeer je de SDK en dotenv voor je TTS API met zowel Python als TypeScript.

Python

pip install elevenlabs
pip install python-dotenv

TypeScript

npm install @elevenlabs/elevenlabs-js
npm install dotenv

Doe je eerste request

Maak vervolgens de client. De client is een object dat ElevenAPI omvat. Maak een .py- of .mts-bestand, afhankelijk van de programmeertaal waarin je schrijft.

Er zijn vier hoofdwaarden die de uitvoer beïnvloeden:

• Stem-ID: ElevenLabs heeft meer dan 17.500 stemmen in onze Voice Library waaruit je kunt kiezen. Selecteer een stem die je applicatie het beste vertegenwoordigt, of stem de stem af op de toepassing. In de onderstaande quickstart-codeblokken gebruiken we “George”, met stem-ID “JBFqnCBsd6RMkjVDRZzb”
• Tekst: De tekenreeks die je door het ElevenAPI TTS-model wilt laten omzetten in een audiobestand. 
• Model-ID: Het specifieke model dat je kiest om audio te genereren. In het onderstaande voorbeeld gebruiken we eleven_v4, maar je kunt ook een van onze Text to Speech-modellen kiezen als een daarvan beter bij je toepassing past. Je kunt bijvoorbeeld kiezen voor Eleven Flash v2.5 (eleven_flash_v2_5 in het model-ID-veld) vanwege de lage latentie.
• Uitvoerformaat: Bepaal welke audiocodering je van de TTS API wilt terugkrijgen. Standaard ontvang je een mp3, maar je kunt ook overstappen op formaten zoals ulaw of pcm.

Zo zien deze TTS API-bestanden eruit in Python en TypeScript. Beide onderstaande voorbeelden gebruiken het model eleven_v4.

Python

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

load_dotenv()

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

audio = elevenlabs.text_to_speech.convert(
    text="The first move is what sets everything in motion.",
    voice_id="JBFqnCBsd6RMkjVDRZzb",  # "George" - browse voices at elevenlabs.io/app/voice-library
    model_id="eleven_v4",
    output_format="mp3_44100_128",
)

play(audio)

TypeScript

import { ElevenLabsClient, play } from "@elevenlabs/elevenlabs-js";
import "dotenv/config";

const elevenlabs = new ElevenLabsClient();
const audio = await elevenlabs.textToSpeech.convert(
	"JBFqnCBsd6RMkjVDRZzb", // "George" - browse voices at elevenlabs.io/app/voice-library
	{
		text: "The first move is what sets everything in motion.",
		modelId: "eleven_v4",
		outputFormat: "mp3_44100_128",
	},
);

await play(audio);

cURL

Je kunt het endpoint ook aanroepen vanuit elke taal die HTTP-requests doet. Dit cURL-voorbeeld verstuurt dezelfde tekst en slaat de audio op in een bestand:

curl -X POST "https://api.elevenlabs.io/v1/text-to-speech/JBFqnCBsd6RMkjVDRZzb?output_format=mp3_44100_128" --output speech.mp3 \
     -H "xi-api-key: $ELEVENLABS_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
  "text": "The first move is what sets everything in motion.",
  "model_id": "eleven_v4"
}'

Voer het uit

Je kunt nu het TTS API-bestand uitvoeren. Voer een van de volgende opdrachten uit, afhankelijk van of je in Python of TypeScript schrijft.

Python

python example.py

TypeScript

npx tsx example.mts

Je zou de audio via je speakers moeten horen. Open bij het cURL-voorbeeld in plaats daarvan speech.mp3.

Veelvoorkomende TTS-integratiefouten oplossen

Als je eerste request mislukt, vergelijk dan de ontvangen statuscode met deze lijst van mogelijke fouten.

Bekijk voor een volledige lijst met fouten de pagina Foutreferentie voor meer informatie. 

Voordelen van het integreren van een Text to Speech API

Door een spraakinterface aan je applicatie toe te voegen, krijgen gebruikers een nieuwe manier om ermee te interacteren. Voor sommigen, zoals mensen met een visuele beperking, is dat misschien de enige praktische manier om je applicatie te gebruiken.

Dit zijn de voordelen van het integreren van een TTS API in je applicatie:

• Toegankelijkheid: Gesproken audio biedt een nieuwe manier om met je applicatie te interacteren, waardoor deze beschikbaar wordt voor mensen die deze niet gemakkelijk op een scherm kunnen lezen.
• Betrokkenheid: Met voorlees- en meeluisterfuncties kunnen gebruikers content tot zich nemen terwijl ze iets anders doen, wat steeds vaker de belangrijkste manier is waarop mensen browsen.
• Spraakgestuurde ervaringen: Gesproken antwoorden geven chatbots en in-appgidsen een natuurlijke manier om met gebruikers terug te praten.
• Meertaligheid: Eleven v4 ondersteunt 90+ talen, waardoor je integratie doelgroepen over de hele wereld kan bedienen.

Vooral omdat het zo eenvoudig in te stellen is, is het integreren van een TTS API in je applicatie een krachtige manier om je applicatie interactiever en expressiever te maken.

De juiste integratiemethode en het juiste model kiezen

Hoewel ElevenAPI een van de snelste en eenvoudigste manieren is om spraak aan een applicatie toe te voegen, kun je afhankelijk van je behoeften ook uit verschillende andere methoden kiezen.

Hier zijn enkele verschillende TTS-integratiemethoden waaruit je kunt kiezen:

Als je voor ElevenAPI kiest, moet je ook bepalen welk model je in je request opneemt. Hier is een korte gids voor de beschikbare ElevenLabs TTS-modellen:

Je kunt ook kiezen uit meer dan 17.500 stemmen in onze Voice Library. Vervang gewoon de voorbeeld-ID in een codefragment door de ID die je wilt gebruiken.

Veelvoorkomende toepassingen van een Text to Speech API in een applicatie

Zodra je eerste request werkt, kan dezelfde aanroep veel functies aandrijven. 

Hier zijn enkele voorbeelden van het gebruik van een TTS API in een applicatie:

• Lezen in de app: Verstuur de tekst in delen en speel de audio op volgorde af. Lees voor meer informatie onze integratiehandleiding voor API-batching.
• Audioreacties van chatbots: Stuur elk antwoord van je chatbot via de API en stream de audio terug naar de gebruiker voor een interactievere ervaring. 
• Telefoonsystemen: Vraag het uitvoerformaat ulaw_8000 aan voor telefonie. Volg onze Twilio TTS-integratiehandleiding voor meer informatie.

Wil je spraakagents bouwen die gesprekken in twee richtingen voeren? Dan is ElevenAgents hiervoor gemaakt. Je configureert en implementeert een agent in het platform, in plaats van zelf de hele spraakpipeline samen te stellen. Verken ElevenAgents voor meer informatie.

Bouw een TTS API in je applicaties met ElevenAPI

Text to Speech integreren komt neer op vier hoofdstappen: maak een API-sleutel, installeer de SDK, doe je eerste request en voer deze vervolgens uit. Dezelfde aanroep werkt in TypeScript, Python of elke andere taal die een HTTP-request kan doen. Je kunt ook het model en de stem kiezen die bij je applicatie passen.

Ben je klaar om TTS in je applicaties te bouwen? Registreer je om vandaag je eerste request met ElevenAPI te doen, of lees meer over de Text to Speech API.

Veelgestelde vragen