Vi presenterar ElevenLabs CLI v1

I dag presenterar vi v1 av ElevenLabs CLI som ger dig ElevenLabs API direkt i terminalen.

Kodningsagenter finns redan i terminalen, där de kör kommandon, läser resultat och till och med beställer lunch. ElevenLabs CLI har utformats med agenter i fokus, med väldokumenterade kommandon och strukturerade JSON-resultat som är enkla att tolka och kedja ihop. Det har ett --dry-run-läge som låter dig förhandsgranska en åtgärd innan den påverkar din arbetsyta.

CLI:t ger också ElevenAgents stöd för agenter som kod. Hämta alla agenter i din arbetsyta till lokala konfigurationsfiler, redigera dem som vilken annan del av din kodbas som helst, förhandsgranska den exakta diffen och skicka till produktion manuellt eller via din kodningsagent.

Installera på 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

Hela plattformen från ett gränssnitt

Varje ElevenLabs API-slutpunkt som publiceras i vår OpenAPI-specifikation finns tillgänglig som underkommando:

# 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

Agenter som kod

Agenter som kod hanterar agentkonfiguration på samma sätt som applikationskod. Du arbetar med filer på disken, och CLI:t håller dem synkroniserade med din arbetsyta. Hela arbetsflödet ryms i tre kommandon.

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

Samma arbetsflöde fungerar även i produktion. Brancher håller utveckling och produktion åtskilda – en utvecklingsbranch kan använda ett testtelefonnummer och en billigare LLM, medan produktionen använder det riktiga numret och en avancerad modell. För nya projekt elevenlabs agents init skapar dessutom grunden för allt, med startmallar för vanliga konfigurationer som kundsupport.

Med en handfull agenter är dashboarden lätt att hantera. Men när du hanterar en grupp agenter utspridda över hundratals kundorganisationer eller massmigrerar agenter från en annan plattform är filer och versionshantering det enda arbetsflöde som skalar.

Byggt för kodningsagenter och utvecklare

En agent som använder ett CLI misslyckas på andra sätt än en människa. Den kan inte svara på en interaktiv fråga, den försöker igen hela tiden och den lär sig av informationen i felmeddelandet. CLI:t är utformat utifrån den verkligheten.

--help är för människor, --schema är för agenter. Varje API-kommando skriver ut ett maskinläsbart kontrakt med typade indata, var varje värde ska anges, vad som krävs och det exakta formatet på svaret. Det gör att agenten kan skapa ett giltigt anrop utan att gissa.

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

Felmeddelanden ger också agenten något att arbeta med. För agenter returneras fel som JSON som de kan tolka. När en mänsklig användare identifieras via TTY visas i stället ett enkelt felmeddelande. Båda innehåller instruktioner om hur du åtgärdar felet.

Med följande ogiltiga kommando:

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

Agenter får följande felmeddelande:

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

Mänskliga användare får däremot se det här mer lättlästa felet, med ett tips om hur problemet kan lösas:

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

Skills ingår

--help och --schema är CLI:ts inbyggda manual. Men skills går längre och lär din kodningsagent hela arbetsflöden, till exempel hur man bygger en agent, genererar tal eller transkriberar ett samtal.

Installera dem i ditt projekt:

elevenlabs generate-skills

Agenter finns redan i terminalen. Nu gör hela ElevenLabs det också. Installera CLI:t, ge din agent skills och se vad den levererar. Kom igång med dokumentationen.