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 primär für Agents entwickelt. Sie bietet gut dokumentierte Befehle und strukturierte JSON-Ergebnisse, die sich leicht parsen und verketten lassen. Mit dem Modus --dry-run können Sie jede Operation prüfen, bevor sie Ihren Workspace verändert.

Die CLI bringt außerdem Agents als Code zu ElevenAgents. Laden Sie jeden Agent in Ihrem Workspace in lokale Konfigurationsdateien, bearbeiten Sie sie wie jeden anderen Teil Ihrer Codebasis, prüfen Sie den genauen Diff und übertragen Sie die Änderungen 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 als Code

Agents als 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 umfasst 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 gilt auch für die Produktion. Branches trennen Entwicklung und Produktion: Ein Dev-Branch kann eine Test-Telefonnummer und ein günstigeres LLM nutzen, während die Produktion die echte Nummer und ein Frontier-Modell verwendet. Für neue Projekte elevenlabs agents init erstellt die gesamte Struktur, einschließlich Startvorlagen für gängige Konfigurationen wie Kundensupport.

Mit wenigen Agents ist das Dashboard gut handhabbar. Verwalten Sie jedoch eine Flotte von Agents für Hunderte Kundenorganisationen oder migrieren Agents massenhaft von einer anderen Plattform, sind Dateien und Versionskontrolle der einzige skalierbare Workflow.

Entwickelt für Coding Agents und Entwickler

Ein Agent, der eine CLI nutzt, scheitert 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 für Agents. Jeder API-Befehl gibt einen maschinenlesbaren Vertrag aus: typisierte Eingaben, ihre Position, erforderliche Angaben und die genaue Form der Antwort. So kann der Agent ohne Raten einen gültigen Aufruf 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, womit er arbeiten kann. Für Agents werden Fehler als parsebares 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.