API y claves de ElevenLabs
| Fase | F2 — Capa de telefonía y generación de voz |
|---|---|
| Módulo | M2.2 — Configuración de voz con ElevenLabs |
| Puntos de profesionalidad al superar el test | 35 |
Objetivo práctico
Al terminar esta lección sabrás crear una clave de API de ElevenLabs con permisos restringidos y un límite de créditos propio, guardarla de forma segura en tu gestor de contraseñas, y revocarla o regenerarla cuando sea necesario.
Resultado que obtendrás
Una clave de API de ElevenLabs creada, restringida y guardada de forma segura, lista para usarse al conectar ElevenLabs con Vapi o Retell en el módulo 2.3.
Dónde encaja dentro del sistema final
Esta clave es la «credencial de la ventanilla» (ver lección de API, módulo 1.2) que permitirá a la plataforma de voz (Vapi o Retell) solicitar audio a ElevenLabs en nombre de tu agente.
Conocimientos previos
- API (módulo 1.2).
- Voces y modelos de ElevenLabs (lección anterior).
Herramientas necesarias
- Cuenta de ElevenLabs activa.
- Gestor de contraseñas.
Posible coste
Crear una clave de API no tiene coste por sí mismo; el coste se genera al usarla para generar audio, según el plan y los créditos disponibles.
Advertencia de seguridad
Una clave de API filtrada permite a cualquiera generar audio (y consumir créditos o saldo) en tu nombre. Trátala con el mismo cuidado que una contraseña: nunca la compartas por correo sin cifrar, ni la publiques en ningún documento accesible públicamente.
Modelo mental
Piensa de nuevo en la ventanilla oficial entre departamentos (lección de API, módulo 1.2): la clave de API es el carné que identifica a quien solicita el servicio en esa ventanilla. Sin carné válido, la ventanilla no atiende la solicitud; con un carné robado, cualquiera podría hacer solicitudes en tu nombre.
Explicación
Según la documentación oficial de ElevenLabs verificada el 30 de agosto de 2026, las claves de API se gestionan desde la sección de ajustes personales de API (o desde la sección de cuentas de servicio, en el caso de un espacio de trabajo de equipo), y admiten tres tipos de restricción configurables al crearlas:
- Restricción de alcance: limitar a qué funciones concretas de la API puede acceder esa clave (por ejemplo, sólo generación de voz, no gestión de la cuenta).
- Cuota de créditos: establecer un límite de créditos propio para esa clave concreta, independiente del límite general de la cuenta. Esta es, en la práctica, la forma más directa que ofrece ElevenLabs de acotar el gasto máximo asociado a una integración concreta (por ejemplo, un cliente concreto).
- Lista de IP permitidas: restringir el uso de la clave a direcciones IP concretas.
Para el trabajo de este curso, la recomendación es crear una clave de API específica por proyecto/cliente, con una cuota de créditos ajustada al presupuesto calculado en el módulo 2.1, en lugar de reutilizar una única clave general para todo. Esto limita el daño potencial si una clave concreta llegara a filtrarse, y facilita separar el consumo real de cada cliente.
Vocabulario nuevo
API Key
Piénsalo así: El carné que te identifica ante la ventanilla de otro departamento.
Cadena de texto secreta que identifica y autoriza a un programa a usar una API en nombre de una cuenta.
Ejemplo: Vapi usa la API Key de ElevenLabs para solicitar la generación de audio en cada llamada.
Preparación
Ten tu cuenta de ElevenLabs iniciada y tu gestor de contraseñas abierto.
Procedimiento paso a paso
Contexto: Vas a crear una clave de API nueva, restringida y con cuota de créditos.
Acción de teclado: Ve a la sección de claves de API personales (busca «API Keys» recorriendo encabezados y botones con H y B) y localiza el botón «Create Key» o equivalente.
Respuesta esperada de NVDA: NVDA debería anunciar un texto similar a «Create Key, botón» o «Crear clave, botón».
Qué significa: Se abrirá un formulario para configurar el nombre, el alcance, la cuota de créditos y, opcionalmente, la caducidad de la clave.
Acción siguiente: Ponle un nombre identificable (por ejemplo, «Torus Academy — proyecto de práctica»), restringe el alcance a lo estrictamente necesario, y establece una cuota de créditos acorde a tu presupuesto de práctica.
Contexto: La clave se ha generado y se muestra en pantalla.
Acción de teclado: Copia la clave inmediatamente con Ctrl + C (ElevenLabs, como la mayoría de plataformas, sólo la muestra una vez) y pégala en una entrada nueva de tu gestor de contraseñas.
Respuesta esperada de NVDA: NVDA leerá la clave si navegas por el campo donde se muestra, o confirmará la copia al portapapeles.
Qué significa: Si cierras esta pantalla sin copiar la clave, tendrás que generar una nueva: la clave no se puede recuperar después.
Acción siguiente: Guarda la entrada en tu gestor de contraseñas con un nombre identificable y una nota de qué proyecto la usa.
Contexto: Quieres revocar una clave que ya no necesitas o que sospechas comprometida.
Acción de teclado: Vuelve a la lista de claves de API, localiza la clave correspondiente y busca la opción «Delete» o «Revoke».
Respuesta esperada de NVDA: NVDA anunciará la opción de eliminación y, normalmente, un diálogo de confirmación.
Qué significa: Una vez revocada, cualquier sistema que la use dejará de poder generar audio inmediatamente.
Acción siguiente: Si necesitas seguir usando la integración, genera una clave nueva y actualízala en la plataforma que la use (Vapi o Retell).
Errores frecuentes y diagnóstico
Cierras la pantalla de creación de clave sin haberla copiado.
Cómo localizarlo: Es un comportamiento intencionado de seguridad de la plataforma: las claves sólo se muestran una vez.
Solución: Genera una clave nueva y elimina la anterior (que ya no sirve, aunque siga apareciendo en la lista hasta que la borres).
Comprobación final
Confirma que tienes una clave de API guardada en tu gestor de contraseñas, con un nombre identificable, un alcance restringido y una cuota de créditos configurada. Si las tres condiciones se cumplen, la comprobación es positiva.
Qué acabas de conseguir
Tienes una credencial de API segura y acotada, lista para conectar ElevenLabs con la plataforma de voz en el módulo 2.3.
Ejercicio práctico
Crea una segunda clave de API con un alcance distinto (por ejemplo, sólo lectura de la biblioteca de voces) y compara en qué se diferencia de la clave de generación de audio que creaste primero.
Resumen de lo imprescindible
- Las claves de API de ElevenLabs admiten restricción de alcance, cuota de créditos propia e IP permitidas.
- Crea una clave específica por proyecto/cliente en lugar de reutilizar una única clave general.
- Copia la clave inmediatamente al crearla: sólo se muestra una vez.
- Revocar una clave detiene de inmediato cualquier uso asociado a ella.
Estoy preparado para continuar si puedo…
- Crear una clave de API de ElevenLabs con alcance y cuota de créditos restringidos.
- Guardarla de forma segura en mi gestor de contraseñas.
- Revocar una clave cuando ya no se necesite.
Fuentes
Última actualización de esta lección: 2026-08-30.
Test de la lección
Para realizar el test y obtener Puntos de profesionalidad necesitas iniciar sesión o crear una cuenta.
Navegación
Lección anterior: Voces y modelos de ElevenLabs en español
Continuar con la siguiente lección: Hito: primera prueba de voz generada