Maak kennis met de ElevenLabs CLI v1

Vandaag introduceren we v1 van de ElevenLabs CLI, waarmee je de ElevenLabs API rechtstreeks in je terminal gebruikt.

Coding agents bevinden zich al in de terminal, waar ze commands uitvoeren, resultaten lezen en zelfs lunch bestellen. De ElevenLabs CLI is ontwikkeld met agents als uitgangspunt en biedt goed gedocumenteerde commands en gestructureerde JSON-resultaten die eenvoudig te parsen en te koppelen zijn. De CLI bevat een --dry-run-modus om elke bewerking te previewen voordat deze je workspace wijzigt.

De CLI brengt agents-as-code ook naar ElevenAgents. Haal elke agent in je workspace op naar lokale configuratiebestanden, bewerk ze zoals elk ander onderdeel van je codebase, preview de exacte diff en push naar productie, handmatig of via je coding agent.

Installeren op 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

Het volledige platform vanuit één interface

Elk ElevenLabs API-endpoint dat is gepubliceerd in onze OpenAPI-specificatie is beschikbaar als subcommand:

# 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

Agents-as-code

Agents-as-code behandelt agentconfiguratie zoals je applicatiecode behandelt. Je werkt met bestanden op schijf en de CLI houdt ze gesynchroniseerd met je workspace. De volledige workflow past in drie commands.

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

Dezelfde workflow werkt ook voor productie. Branches houden ontwikkeling en productie gescheiden: een dev branch kan een testtelefoonnummer en een goedkoper LLM gebruiken, terwijl productie het echte nummer en een frontier model gebruikt. En voor nieuwe projecten elevenlabs agents init alles scaffoldt, met starter templates voor veelvoorkomende configuraties zoals klantenservice.

Met een handvol agents is het dashboard overzichtelijk. Maar wanneer je een groot aantal agents beheert, verspreid over honderden klantorganisaties, of agents in bulk migreert vanaf een ander platform, zijn bestanden en versiebeheer de enige workflow die schaalbaar is.

Ontwikkeld voor coding agents en ontwikkelaars

Een agent die een CLI gebruikt, loopt op een andere manier tegen fouten aan dan een persoon. Een agent kan niet reageren op een interactieve prompt, probeert het voortdurend opnieuw en leert van wat de foutmelding biedt. De CLI is ontworpen rond deze realiteit.

--help is voor mensen, --schema is voor agents. Elk API-command print een machineleesbaar contract met getypeerde inputs, waar elke input hoort, wat verplicht is en de exacte structuur van de response. Zo kan de agent zonder te gokken een geldige aanroep opbouwen.

$ 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"]
  }
}

Fouten geven de agent ook iets om mee te werken. Voor agents worden fouten teruggegeven als JSON die ze kunnen parsen. Wanneer via TTY een menselijke gebruiker wordt gedetecteerd, wordt in plaats daarvan een gewone foutmelding getoond. Beide bevatten instructies om de fout op te lossen.

Bij het volgende ongeldige command:

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

Agents krijgen de volgende foutmelding:

$ 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"
  }
}

Menselijke gebruikers zien daarentegen deze beter leesbare foutmelding, met een hint om het probleem op te lossen:

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

Skills zijn standaard inbegrepen

--help en --schema vormen de ingebouwde handleiding van de CLI. Maar skills gaan verder en leren je coding agent complete workflows, zoals een agent bouwen, spraak genereren of een gesprek transcriberen.

Installeer ze in je project:

elevenlabs generate-skills

Agents bevinden zich al in de terminal. Nu geldt dat ook voor heel ElevenLabs. Installeer de CLI, geef je agent de skills en ontdek wat die oplevert. Ga aan de slag met de documentatie.