Presentamos ElevenLabs CLI v1.0

Hoy presentamos la v1 de ElevenLabs CLI, que lleva la API de ElevenLabs directamente a tu terminal.

Agentes de programación ya trabajan en el terminal, donde ejecutan comandos, leen resultados e incluso piden comida. ElevenLabs CLI se ha diseñado pensando primero en agentes, con comandos bien documentados y resultados JSON estructurados que se pueden analizar y encadenar fácilmente. Incluye un modo --dry-run para previsualizar cualquier operación antes de que afecte a tu espacio de trabajo.

La CLI también incorpora agentes como código a ElevenAgents. Descarga cada agente de tu espacio de trabajo en archivos de configuración locales, edítalos como cualquier otra parte de tu base de código, previsualiza el diff exacto y súbelo a producción manualmente o mediante tu agente de programación.

Instalar en macOS

brew install elevenlabs/tap/elevenlabs

Windows

scoop bucket add elevenlabs https://github.com/elevenlabs/scoop-bucket
scoop install elevenlabs

cURL

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | sh

Toda la plataforma desde una interfaz

Todas las rutas de la API de ElevenLabs publicadas en nuestra especificación OpenAPI están disponibles como subcomandos:

# list every agent in your workspace as structured JSON 
elevenlabs agents list --format json

# compose a song from a prompt
elevenlabs music compose --prompt "lo-fi track for a rainy afternoon" --output track.mp3

# speak a sentence and save the audio
elevenlabs text-to-speech convert --voice-id gPPH6SLdL8XSX6GNJ40G --text "Hello from the CLI" --output hello.mp3

Agentes como código

Agentes como código trata la configuración de agentes igual que el código de una aplicación. Trabajas con archivos en disco y la CLI los mantiene sincronizados con tu espacio de trabajo. Todo el workflow se resume en tres comandos.

elevenlabs agents pull              # every agent in your workspace becomes a local config file
# edit a config: change the greeting, swap the voice, update the prompt
elevenlabs agents push --dry-run    # preview exactly what would change, without changing anything
elevenlabs agents push              # apply

El mismo workflow se extiende a producción. Las ramas mantienen separados desarrollo y producción: una rama de desarrollo puede usar un número de teléfono de prueba y un LLM más económico, mientras que producción usa el número real y un modelo de última generación. Para proyectos nuevos, elevenlabs agents init crea toda la estructura, con plantillas iniciales para configuraciones habituales como atención al cliente.

Con unos pocos agentes, el panel es fácil de gestionar. Sin embargo, cuando gestionas una flota de agentes repartida entre cientos de organizaciones de clientes o migras agentes en bloque desde otra plataforma, los archivos y el control de versiones son el único workflow que escala.

Creado para agentes de programación y desarrolladores

Un agente que usa una CLI falla de forma distinta a una persona. No puede responder a una solicitud interactiva, reintenta constantemente y aprende de lo que le indique el mensaje de error. La CLI está diseñada teniendo en cuenta esta realidad.

--help es para personas; --schema es para agentes. Cada comando de la API muestra un contrato legible por máquina con entradas tipadas, dónde va cada una, qué es obligatorio y la estructura exacta de la respuesta. Así, el agente puede construir una llamada válida sin tener que adivinar.

$ elevenlabs text-to-speech convert --schema
{
  "operation": "text-to-speech.convert",
  "description": "Create speech",
  "binaryResponse": true,
  "input": {
    "properties": {
      "text": { "location": "body", "type": "string" },
      "voice_id": { "location": "path", "type": "string" },
      ...
    },
    "required": ["text", "voice_id"]
  }
}

Los errores también dan al agente información con la que trabajar. Para agentes, los errores se devuelven como JSON que pueden analizar. Cuando se detecta a un usuario humano a través de TTY, se muestra en su lugar un mensaje de error en texto plano. Ambos incluyen instrucciones para solucionar el error.

Con el siguiente comando no válido:

$ elevenlabs text-to-speech convert --text "Hello from the CLI"

Agentes recibirían el siguiente mensaje de error:

$ elevenlabs text-to-speech convert --text "Hello from the CLI"
{
  "error": {
    "code": 400,
    "message": "Required parameter 'voice_id' is missing. Provide it via --voice-id or --params",
    "reason": "validationError"
  }
}

En cambio, usuarios humanos ven este error, más legible e incluye una indicación para solucionar el problema:

error[validation]:
 Required parameter 'voice_id' is missing. Provide it via --voice-id or --params
 Try `elevenlabs text-to-speech convert --help`

Skills incluidas de serie

--help y --schema son el manual integrado de la CLI. Pero las skills van más allá y enseñan a tu agente de programación workflows completos, como crear un agente, generar voz o transcribir una llamada.

Instálalas en tu proyecto:

elevenlabs generate-skills

Agentes ya trabajan en el terminal. Ahora, todo ElevenLabs también. Instala la CLI, proporciona las skills a tu agente y descubre qué crea. Empieza con la documentación.