Saltar a la navegación

Guía de inicio rápido de ElevenAPI

Descubre cómo hacer tu primera solicitud a la API de ElevenLabs.

Al final de esta guía, tendrás ElevenLabs configurado en tu proyecto y podrás hacer tu primera solicitud de Texto a Voz. Hay dos formas de hacerlo: dejar que tu agente de programación realice la configuración o hacerlo manualmente.

Para consultar guías sobre otras funcionalidades —streaming, clonar voz, voz a texto—, ve a la sección de Tutoriales.

Configúralo con tu agente de programación

No necesitas una cuenta ni una clave de API antes de empezar. Pega esto en tu agente de programación:

Add ElevenLabs to my project: run `npx -y @elevenlabs/cli@latest onboard init` and follow what it prints.

La CLI de ElevenLabs se encarga del resto e indica a tu agente cada paso. Tu navegador se abrirá una vez para que puedas iniciar sesión o crear una cuenta y hacer clic en Autorizar. La clave se guarda en el archivo de entorno de tu proyecto (.env.local o .env en un proyecto de Python) y se mantiene fuera de git; nunca se muestra en el chat. A continuación, el agente te pregunta qué quieres crear, instala el SDK, añade el código a tu aplicación y pregunta si quieres enviar una solicitud de prueba.

Si tu agente se ejecuta en algún lugar al que tu navegador no puede acceder, como una máquina remota mediante SSH o un sandbox en la nube, la CLI te pide que crees una clave tú mismo y la pegues en el archivo de entorno; después continúa. El comando necesita Node.js para npx. Si no lo tienes, instala la CLI de ElevenLabs con Homebrew (macOS y Linux) o Scoop (Windows), o actualízala si ya la tienes (brew upgrade elevenlabs, scoop update elevenlabs), y pide a tu agente que ejecute elevenlabs onboard init en su lugar.

Configúralo manualmente

1

Crea una clave de API

Crea una clave de API en el panel aquí, 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 los altavoces, es posible que se te pida instalar MPV o ffmpeg.

3

Haz tu primera solicitud

Crea un archivo llamado example.py o example.mts, según el lenguaje que elijas, 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 los altavoces.

Siguientes pasos