Einführung der ElevenLabs CLI v1.0

Heute stellen wir v1 der ElevenLabs CLI vor, die die ElevenLabs API direkt in Ihr Terminal bringt.

Coding Agents arbeiten bereits im Terminal: Sie führen Befehle aus, lesen Ergebnisse und bestellen sogar Mittagessen. Die ElevenLabs CLI wurde für Agents entwickelt. Sie bietet gut dokumentierte Befehle und strukturierte JSON-Ergebnisse, die sich einfach parsen und verketten lassen. Mit dem --dry-run-Modus können Sie jede Operation prüfen, bevor sie Ihren Workspace verändert.

Die CLI bringt außerdem Agents as Code zu ElevenAgents. Ziehen Sie jeden Agent aus Ihrem Workspace in lokale Konfigurationsdateien, bearbeiten Sie sie wie jeden anderen Teil Ihrer Codebasis, prüfen Sie den genauen Diff und übertragen Sie sie manuell oder über Ihren Coding Agent in die Produktion.

Installation unter 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

Die gesamte Plattform über eine Oberfläche

Jeder in unserer OpenAPI-Spezifikation veröffentlichte ElevenLabs-API-Endpunkt ist als Unterbefehl verfügbar:

# 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 Agent-Konfigurationen wie Anwendungscode. Sie arbeiten mit Dateien auf dem Datenträger, und die CLI hält sie mit Ihrem Workspace synchron. Der gesamte Workflow passt in drei Befehle.

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

Derselbe Workflow funktioniert auch für die Produktion. Branches trennen Entwicklung und Produktion: Ein Dev-Branch kann eine Testtelefonnummer und ein günstigeres LLM verwenden, während die Produktion die echte Nummer und ein Frontier-Modell nutzt. Für neue Projekte elevenlabs agents init erstellt die gesamte Grundstruktur – mit Startvorlagen für gängige Konfigurationen wie Kundensupport.

Mit einer Handvoll Agents ist das Dashboard gut zu verwalten. Wenn Sie jedoch eine Flotte von Agents über Hunderte Kundenorganisationen hinweg verwalten oder Agents in großer Zahl von einer anderen Plattform migrieren, sind Dateien und Versionskontrolle der einzige skalierbare Workflow.

Entwickelt für Coding Agents und Entwickler

Ein Agent scheitert bei der Nutzung einer CLI anders als ein Mensch. Er kann keine interaktive Eingabeaufforderung beantworten, versucht es ständig erneut und lernt aus den Informationen in Fehlermeldungen. Die CLI ist auf diese Realität ausgelegt.

--help ist für Menschen, --schema ist für Agents. Jeder API-Befehl gibt einen maschinenlesbaren Vertrag aus: typisierte Eingaben, ihre Position, erforderliche Angaben und die genaue Struktur der Antwort. So kann der Agent einen gültigen Aufruf ohne Raten erstellen.

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

Auch Fehler geben dem Agent etwas, mit dem er arbeiten kann. Für Agents werden Fehler als parsbares JSON zurückgegeben. Wird über TTY ein menschlicher Nutzer erkannt, erscheint stattdessen eine einfache Fehlermeldung. Beide enthalten Hinweise zur Behebung des Fehlers.

Bei diesem ungültigen Befehl:

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

Agents erhalten folgende Fehlermeldung:

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

Menschliche Nutzer sehen dagegen diesen besser lesbaren Fehler mit einem Hinweis zur Behebung des Problems:

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

Skills sind direkt enthalten

--help und --schema sind das integrierte Handbuch der CLI. Skills gehen jedoch weiter und vermitteln Ihrem Coding Agent vollständige Workflows – etwa zum Erstellen eines Agents, Generieren von Sprache oder Transkribieren eines Anrufs.

Installieren Sie sie in Ihrem Projekt:

elevenlabs generate-skills

Agents arbeiten bereits im Terminal. Jetzt gilt das auch für ganz ElevenLabs. Installieren Sie die CLI, geben Sie Ihrem Agent die Skills und sehen Sie, was er erstellt. Starten Sie mit der Dokumentation.