Ir al contenido

Comandos de ElevenLabs

Comandos y flujos de trabajo completos de síntesis de voz AI de ElevenLabs para texto a voz y generación de voz.

Autenticación de API

ComandoDescripción
curl -H "xi-api-key: <api-key>" <endpoint>Autenticación de API
export ELEVEN_API_KEY=<key>Establecer variable de entorno
elevenlabs auth loginIniciar sesión en la cuenta
elevenlabs auth logoutCerrar sesión de la cuenta
elevenlabs auth statusVerificar estado de autenticación

API de Texto a Voz

EndpointDescripción
POST /v1/text-to-speech/{voice_id}Generar voz
POST /v1/text-to-speech/{voice_id}/streamTransmitir voz
GET /v1/voicesLista de voces disponibles
GET /v1/voices/{voice_id}Obtener detalles de voz
POST /v1/voices/addAgregar voz personalizada

Gestión de Voces

ComandoDescripción
GET /v1/voicesListar todas las voces
GET /v1/voices/{voice_id}Obtener información de voz
DELETE /v1/voices/{voice_id}Eliminar voz personalizada
POST /v1/voices/{voice_id}/editEditar configuración de voz
GET /v1/voices/settingsObtener configuración de voz

Generación de Voz

ComandoDescripción
curl -X POST "https://api.elevenlabs.io/v1/text-to-speech/21m00Tcm4TlvDq8ikWAM" -H "xi-api-key: <key>" -H "Content-Type: application/json" -d '{"text": "Hello world"}'Generación básica de voz
curl -X POST "https://api.elevenlabs.io/v1/text-to-speech/21m00Tcm4TlvDq8ikWAM/stream" -H "xi-api-key: <key>"Streaming de voz

SDK de Python

ComandoDescripción
pip install elevenlabsInstalar Python SDK
from elevenlabs import generate, playImportar SDK
generate(text="Hello", voice="Bella")Generar voz
play(audio)Reproducir audio generado
save(audio, "output.mp3")Guardar archivo de audio

Clonación de Voz

ComandoDescripción
POST /v1/voices/addClonar voz a partir de muestras
POST /v1/voices/{voice_id}/samplesAgregar muestras de voz
DELETE /v1/voices/{voice_id}/samples/{sample_id}Eliminar muestra de voz
GET /v1/voices/{voice_id}/samplesListar muestras de voz

Configuración de Voz

ParámetroDescripción
stabilityConsistencia de voz (0.0-1.0)
similarity_boostSimilitud de voz (0.0-1.0)
styleEstilo de habla (0.0-1.0)
use_speaker_boostMejorar similitud de altavoces

Formatos de Audio

FormatoDescripción
mp3_44100_128MP3 44.1kHz 128kbps
mp3_22050_32MP3 22.05kHz 32kbps
pcm_16000PCM 16kHz
pcm_22050PCM 22.05kHz
pcm_24000PCM 24kHz
pcm_44100PCM 44.1kHz

Voces Predefinidas

Voice IDNombreDescripción
21m00Tcm4TlvDq8ikWAMRachelAmericana femenina
AZnzlk1XvdvUeBnXmlldDomiAmericana femenina
EXAVITQu4vr4xnSDxMaLBellaAmericana femenina
ErXwobaYiN019PkySvjVAntoniMasculino estadounidense
MF3mGyEYCl7XYWbV9V6OElliAmericana femenina
TxGEqnHWrfWFTfGW9XjXJoshMasculino estadounidense
VR6AewLTigWG4xSOukaGArnoldMasculino estadounidense
pNInz6obpgDQGcFmaJgBAdamMasculino estadounidense

SDK de Node.js

ComandoDescripción
npm install elevenlabsInstalar Node.js SDK
const { ElevenLabsAPI } = require('elevenlabs')Importar SDK
const client = new ElevenLabsAPI({ apiKey: 'key' })Inicializar cliente
client.textToSpeech.generate()Generar voz

Transmisión de Audio

ComandoDescripción
POST /v1/text-to-speech/{voice_id}/streamTransmitir audio
curl -X POST -H "xi-api-key: <key>" --data-raw '{"text":"Hello"}' --output audio.mp3Transmitir a archivo

Características de Voice Lab

CaracterísticaDescripción
Voice DesignCrear voces sintéticas
Voice CloningClonar voces existentes
Professional CloningClonación de voz de alta calidad
Voice LibraryExaminar colección de voces

Límites de Tasa de API

PlanCaracteres/MesSolicitudes Concurrentes
Free10.0002
Starter30.0003
Creator100.0005
Pro500.00010
Scale2.000.00025

Manejo de Errores

Código de ErrorDescripción
400Solicitud Incorrecta
401No autorizado
403Prohibido
404Not Found
422Entidad No Procesable
429Demasiadas Solicitudes
500Error Interno del Servidor

Parámetros Avanzados

ParámetroDescripción
model_idModelo TTS a utilizar
voice_settingsConfiguración de voz
pronunciation_dictionary_locatorsPronunciaciones personalizadas
seedGeneración reproducible

Configuración de Webhook

ComandoDescripción
POST /v1/webhooksCrear webhook
GET /v1/webhooksListar webhooks
DELETE /v1/webhooks/{webhook_id}Eliminar webhook
PUT /v1/webhooks/{webhook_id}Actualizar webhook

Proyectos y Doblaje

ComandoDescripción
POST /v1/projectsCrear proyecto
GET /v1/projectsListar proyectos
POST /v1/dubbingCrear proyecto de doblaje
GET /v1/dubbing/{dubbing_id}Obtener estado de doblaje

Análisis de Uso

ComandoDescripción
GET /v1/user/subscriptionObtener información de suscripción
GET /v1/userObtener información del usuario
GET /v1/usage/character-statsObtener estadísticas de uso

Herramienta CLI

ComandoDescripción
elevenlabs --helpMostrar ayuda
elevenlabs tts --text "Hello" --voice RachelGenerar voz
elevenlabs voices listListar voces
elevenlabs voices clone --name "MyVoice"Clonar voz
CódigoDescripción
audio = generate(text="Hello", voice="Bella", model="eleven_monolingual_v1")Generación básica
play(audio)Reproducir audio
save(audio, "hello.mp3")Guardar en archivo
CódigoDescripción
const audio = await elevenlabs.generate({ text: "Hello", voice: "Rachel" })Generar audio
fs.writeFileSync("audio.mp3", audio)Guardar en archivo
PasoDescripción
1. Upload samplesProporcionar muestras de voz
2. Train modelAI aprende patrones de voz
3. Test generationVerificar calidad de voz
4. Fine-tune settingsAjustar parámetros
5. Deploy voiceUsar en producción
PrácticaDescripción
Clear audio samplesGrabaciones de alta calidad
Diverse samplesVarias emociones/estilos
Consistent speakerLa misma persona durante todo el tiempo
Proper length1-5 minutos en total
Good microphoneGrabación profesional
PlatformIntegración
Discord BotGeneración de mensajes de voz
PodcastNarración automatizada
E-learningLocuciones de curso
GamingVoces de personajes
AccessibilityTexto a voz para personas con discapacidad visual
ProblemaSolución
Poor voice qualityMejorar la calidad de la muestra
Rate limit exceededActualizar plan o esperar
Authentication failedVerificar clave API
Voice not foundVerificar ID de voz
Audio distortionAjustar configuración de voz
VariableDescripción
ELEVEN_API_KEYClave de autenticación API
ELEVEN_API_URLURL base de API
ELEVEN_TIMEOUTTiempo de espera de solicitud
ArchivoDescripción
.elevenlabs.jsonArchivo de configuración
voices.jsonDefiniciones de voz
settings.jsonConfiguración predeterminada
MétricaDescripción
----------------------
Characters usedUso mensual
API callsRecuento de solicitudes
Voice generationsAudio creado
Error rateSolicitudes fallidas