Saltar a la navegación
Guías prácticasTexto a Voz

Uso de diccionarios de pronunciación

Esta guía te muestra cómo gestionar diccionarios de pronunciación mediante programación.

Guía práctica · Da por hecho que has completado la guía de inicio rápido de ElevenAPI .

Descripción general

Los diccionarios de pronunciación te permiten personalizar cómo pronuncia tu agente de IA palabras o frases específicas. Esto resulta especialmente útil para:

  • Corregir la pronunciación de nombres, lugares o términos técnicos
  • Garantizar una pronunciación coherente en todas las conversaciones
  • Personalizar variaciones regionales de pronunciación

ElevenLabs admite los alfabetos IPA y CMU.

Las etiquetas de fonemas de los diccionarios de pronunciación solo funcionan con los modelos eleven_v4, eleven_v4_turbo, eleven_flash_v2 y eleven_v3.

Otros modelos omiten las etiquetas de fonemas del diccionario y usan la pronunciación predeterminada. Para otros modelos, usa en su lugar etiquetas de alias para sustituir grafías o frases que produzcan la pronunciación que necesitas.

Si quieres usar pronunciaciones IPA y CMU en idiomas distintos del inglés, tendrás que cambiar al modelo eleven_v4 o eleven_v4_turbo.

Inicio rápido

Esta guía da por hecho que has configurado tu clave de API y el SDK. Completa primero la guía de inicio rápido si aún no lo has hecho.

1

Crea un archivo de diccionario de pronunciación

En este ejemplo, crearemos un archivo de diccionario de pronunciación para la palabra tomato.

Esta regla usará el alfabeto «IPA» y actualizará la pronunciación de tomato y Tomato con una pronunciación distinta. Los archivos PLS distinguen entre mayúsculas y minúsculas, por eso incluimos ambas formas, con y sin «T» mayúscula.

Puedes usar herramientas de IA como Claude o ChatGPT para generar notaciones IPA o CMU de palabras específicas.

dictionary.pls
<?xml version="1.0" encoding="UTF-8"?>
<lexicon version="1.0"
    xmlns="http://www.w3.org/2005/01/pronunciation-lexicon"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.w3.org/2005/01/pronunciation-lexicon
        http://www.w3.org/TR/2007/CR-pronunciation-lexicon-20071212/pls.xsd"
    alphabet="ipa" xml:lang="en-US">
<lexeme>
    <grapheme>tomato</grapheme>
    <phoneme>/tə'meɪtoʊ/</phoneme>
</lexeme>
<lexeme>
    <grapheme>Tomato</grapheme>
    <phoneme>/tə'meɪtoʊ/</phoneme>
</lexeme>
</lexicon>
2

Crea un diccionario de pronunciación a partir de un archivo mediante el SDK

Crea un archivo nuevo llamado example.py o example.mts, según el lenguaje que prefieras, y añade el siguiente código:

from elevenlabs import ElevenLabs, PronunciationDictionaryVersionLocator
from elevenlabs.play import play
elevenlabs = ElevenLabs()
with open("dictionary.pls", "rb") as f:
    # this dictionary changes how tomato is pronounced
    pronunciation_dictionary = elevenlabs.pronunciation_dictionaries.create_from_file(
        file=f.read(), name="example"
    )
audio_1 = elevenlabs.text_to_speech.convert(
    text="Without the dictionary: tomato",
    voice_id="aMSt68OGf4xUZAnLpTU8",
    model_id="eleven_v4_turbo",
)
audio_2 = elevenlabs.text_to_speech.convert(
    text="With the dictionary: tomato",
    voice_id="aMSt68OGf4xUZAnLpTU8",
    model_id="eleven_v4_turbo",
    pronunciation_dictionary_locators=[
        PronunciationDictionaryVersionLocator(
            pronunciation_dictionary_id=pronunciation_dictionary.id,
            version_id=pronunciation_dictionary.version_id,
        )
    ],
)
# play the audio
play(audio_1)
play(audio_2)
3

Ejecuta el código

python example.py

Deberías escuchar por los altavoces dos versiones del audio: una con el diccionario de pronunciación y otra sin él.

Próximos pasos

Referencia de la API

Referencia completa de la API de diccionarios de pronunciación.

Streaming de Texto a Voz

Transmite Texto a Voz de forma progresiva para una reproducción con menor latencia.