/setup-elevenlabs.es

description: "Lesson command"
duration: "~10 min"
prerequisites: ["Navegador disponible", "Tener correo electrónico o cuenta de Google/GitHub"]
level: "beginner"
tags: ["setup", "elevenlabs", "api", "tts", "voice"]
nonInteractiveMode: deferred

Configuración de la API de ElevenLabs

Step 0: Verificar el progreso de configuración

**Lo que la IA ejecuta automáticamente:** 1. Ejecutar `uv run python tools/setup_progress.py show --current setup-elevenlabs` para mostrar el progreso 2. Detectar automáticamente la clave de API existente:

• Ejecutar `uv run python tools/credential_manager.py status`
• Si ELEVENLABS_API_KEY (o ELEVEN_API_KEY) ya está configurada, puede ejecutar solo el Step 4 (prueba de API) y marcarlo como completado
• Si existe una clave en texto plano en `.env`, sugerir la migración al almacén de credenciales

Lo que hará en esta sesión

| Elemento | Contenido | |----------|-----------| | Objetivo | Obtener una clave de API de ElevenLabs y guardarla en el Almacén de credenciales para poder usar las funciones de texto a voz (TTS) y síntesis de voz | | Duración | ~10 minutos | | Requisitos previos | Una dirección de correo electrónico o cuenta de Google/GitHub, y un navegador disponible | | Nivel de operación | No se necesitan comandos CLI (todo lo ejecuta automáticamente la IA + solo operaciones de GUI) |

**Casos de uso:** ElevenLabs es un servicio de síntesis de voz con IA (TTS). Admite texto a voz, clonación de voz y síntesis de voz multilingüe, utilizado para generar narraciones de video y más.

**Sobre los costos:** El plan gratuito permite hasta 10.000 caracteres al mes. Esto es más que suficiente para el uso a nivel de curso.

**Flujo de la sesión:** 1. Abrir ElevenLabs en el navegador (la IA abre el navegador automáticamente) 2. Crear una cuenta / iniciar sesión (registrarse mediante autenticación de Google/GitHub) 3. Obtener su clave de API (solo copiarla desde la página de configuración) 4. Guardar en el Almacén de credenciales (ejecutar un comando en una terminal separada) 5. Prueba de funcionalidad (la IA lo ejecuta automáticamente)

> **Consejo**: Si la respuesta de la IA se detiene a mitad de camino, escriba "por favor continúe" o "se detuvo" para reanudar.

---

Verificación de preparación

**Configuración de AskQuestion:**

{
  "title": "Confirmación antes de la sesión",
  "questions": [{
    "id": "readiness",
    "prompt": "¿Está preparado/a?",
    "options": [
      {"id": "ready", "label": "¡Preparado/a! Comencemos"},
      {"id": "chrome", "label": "Automatizar operaciones del navegador con /chrome"},
      {"id": "check_prereq", "label": "Quiero verificar los requisitos previos"},
      {"id": "different_lesson", "label": "Quiero ir a otra lección"}
    ]
  }]
}

(ready -> Ir al Step 1) (chrome -> Después de abrir el navegador en el Step 1, seguir la sección "Automatización con integración Chrome" para la ejecución automática) (check_prereq -> Indicar: "Está listo/a si tiene una dirección de correo electrónico o una cuenta de Google/GitHub. El plan gratuito permite hasta 10.000 caracteres al mes.") (different_lesson -> Mostrar la lista de módulos)

---

Step 1: Abrir ElevenLabs en el navegador

**Lo que hace la IA:** 1. Detectar automáticamente el SO (Mac / Windows / Linux) 2. Ejecutar el siguiente comando para abrir el navegador automáticamente:

# Mac:
open https://elevenlabs.io
# Windows:
start https://elevenlabs.io
# Linux:
xdg-open https://elevenlabs.io

**Después de que se abra el navegador, mostrar la siguiente AskQuestion:**

{
  "title": "Step 1: Registrarse / Iniciar sesión en ElevenLabs",
  "questions": [{
    "id": "signup_status",
    "prompt": "¿Se abrió el navegador? Siga estos pasos para crear su cuenta:\n\n1. Haga clic en 'Sign up' en la parte superior derecha (o 'Log in' si ya tiene cuenta)\n2. Regístrese con autenticación de Google / GitHub, o con su dirección de correo electrónico\n3. Una vez que haya iniciado sesión, continúe con el siguiente paso\n\n¿Ha iniciado sesión?",
    "options": [
      {"id": "logged_in", "label": "¡He iniciado sesión!"},
      {"id": "browser_not_open", "label": "El navegador no se abrió"},
      {"id": "signup_issue", "label": "Tengo problemas para registrarme"},
      {"id": "already_have_key", "label": "Ya tengo una clave de API"}
    ]
  }]
}

(logged_in -> Ir al Step 2) (browser_not_open -> Indicar: "Abra esta URL directamente en su navegador: https://elevenlabs.io") (signup_issue -> Indicar: "La autenticación de Google es la más fácil. Haga clic en Sign up en la parte superior derecha -> Continue with Google. Si no funciona, intente registrarse con su dirección de correo electrónico.") (already_have_key -> Saltar al Step 3)

---

Automatización con integración Chrome (modo `/chrome`)

**Requisito previo:** La extensión "Claude in Chrome" (v1.0.36+) debe estar instalada en Chrome, y debe haber iniciado con `claude --chrome` o ejecutado `/chrome` en la sesión.

**Lo que la IA ejecuta automáticamente con la integración Chrome:** 1. Abrir https://elevenlabs.io en el navegador 2. Usar la integración Chrome para realizar las siguientes operaciones en orden:

• Hacer clic en "Sign up" o "Log in"
• Autenticarse con Google, GitHub o correo electrónico (esperar la acción del usuario)
• Después de iniciar sesión, navegar a https://elevenlabs.io/app/settings/api-keys
• Si hay una clave existente, dejarla como está; de lo contrario hacer clic en "Create API Key"

3. Una vez que se muestre la clave de API, indicar al usuario "Haga clic en el botón de copiar junto a la clave de API para copiarla" 4. Ir al Step 3

**Nota:** No leer el valor de la clave de API desde la pantalla del navegador. El usuario la copia manualmente.

Si la integración Chrome no está disponible, siga los pasos a continuación manualmente.

---

Step 2: Obtener su clave de API

**Lo que hace la IA:** 1. Abrir la página de claves de API en el navegador:

# Ma