Primeros pasos

Guía de inicio rápido de ElevenAPI

Aprende a realizar tu primera solicitud a la API de ElevenLabs.

Al final de esta guía tendrás un script funcional que envía una cadena de texto a la API de ElevenLabs y reproduce el audio devuelto por tus altavoces. Aprenderás a autenticarte con una clave de API, instalar el SDK y realizar tu primera solicitud de texto a voz.

Para consultar guías sobre otras funcionalidades —transmisión, clonación de voz y voz a texto—, consulta la sección Tutoriales.

Utiliza la skill de texto a voz de ElevenLabs para generar voz desde tu asistente de programación con IA:

npx skills add elevenlabs/skills --skill text-to-speech

Uso de la API de Texto a Voz

1

Crea una clave de API

Crea una clave de API aquí, en el panel, que usarás para acceder a la API de forma segura.

Guarda la clave como un secreto gestionado y pásala a los SDK como variable de entorno mediante un archivo .env, o directamente en la configuración de tu aplicación, según prefieras.

.env
ELEVENLABS_API_KEY=<your_api_key_here>
2

Instala el SDK

También usaremos la biblioteca dotenv para cargar nuestra clave de API desde una variable de entorno.

pip install elevenlabs
pip install python-dotenv

Para reproducir el audio por tus altavoces, es posible que se te pida instalar MPV o ffmpeg.

3

Haz tu primera solicitud

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

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)

Después, ejecútalo:

python example.py

Deberías oír el audio por tus altavoces.

Siguientes pasos

Transmite audio

Reduce la latencia transmitiendo el audio a medida que se genera, en lugar de esperar al archivo completo

Explora voces

Explora más de 10.000 voces y sustituye el ID de voz de ejemplo por uno adecuado para tu caso de uso

Clona una voz

Crea una voz personalizada a partir de una grabación de audio corta