Vi presenterar ElevenLabs CLI v1

I dag lanserar 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 är utvecklad med agenter i fokus och erbjuder väldokumenterade kommandon och strukturerade JSON-resultat som är enkla att tolka och kedja ihop. Den innehåller ett --dry-run-läge där du kan förhandsgranska en åtgärd innan den påverkar din workspace.

CLI:t ger också agents-as-code till ElevenAgents. Hämta alla agenter i din workspace till lokala konfigurationsfiler, redigera dem som vilken annan del av din kodbas som helst, förhandsgranska den exakta diffen och pusha 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-endpoint som publicerats 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

Agents-as-code hanterar agentkonfiguration på samma sätt som applikationskod. Du arbetar med filer på disken, och CLI:t håller dem synkroniserade med din workspace. 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 för produktion. Brancher håller utveckling och produktion separerade – 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 allt du behöver, med startmallar för vanliga konfigurationer som kundtjänst.

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

Byggd för kodningsagenter och utvecklare

En agent som använder ett CLI misslyckas på ett annat 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 det som felmeddelandet ger den. 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 responsens exakta struktur. Det låter agenten 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"]
  }
}

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

Med det ogiltiga kommandot:

$ 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 ser däremot det här mer lättlästa felet, med ett tips om hur problemet åtgärdas:

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 handbok. Men skills går längre och lär din kodningsagent kompletta arbetsflöden, som 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.