KosmoKrator

ai

ElevenLabs CLI for AI Agents

Use the ElevenLabs CLI from KosmoKrator to call ElevenLabs tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

6 functions 4 read 2 write API key auth

ElevenLabs CLI Setup

ElevenLabs can be configured headlessly with `kosmokrator integrations:configure eleven-labs`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure eleven-labs --set api_key="$ELEVEN_LABS_API_KEY" --enable --read allow --write ask --json
kosmokrator integrations:doctor eleven-labs --json
kosmokrator integrations:status --json

Credentials

Authentication type: API key api_key. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

KeyEnv varTypeRequiredLabel
api_key ELEVEN_LABS_API_KEY Secret secret yes API Key
url ELEVEN_LABS_URL URL url no API Base URL

Call ElevenLabs Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call eleven-labs.elevenlabs_list_voices '{
  "limit": 1,
  "page": 1
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:eleven-labs elevenlabs_list_voices '{
  "limit": 1,
  "page": 1
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs eleven-labs --json
kosmo integrations:docs eleven-labs.elevenlabs_list_voices --json
kosmo integrations:schema eleven-labs.elevenlabs_list_voices --json
kosmo integrations:search "ElevenLabs" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to ElevenLabs.

eleven-labs.elevenlabs_list_voices

Read read

List available ElevenLabs voices. Returns voice names, IDs, labels, and preview URLs. Use this to discover voices for text-to-speech generation.

Parameters
limit, page

Generic CLI call

kosmo integrations:call eleven-labs.elevenlabs_list_voices '{"limit":1,"page":1}' --json

Provider shortcut

kosmo integrations:eleven-labs elevenlabs_list_voices '{"limit":1,"page":1}' --json

eleven-labs.elevenlabs_get_voice

Read read

Get detailed information about a specific ElevenLabs voice by its ID, including name, labels, description, and preview URL.

Parameters
voice_id

Generic CLI call

kosmo integrations:call eleven-labs.elevenlabs_get_voice '{"voice_id":"example_voice_id"}' --json

Provider shortcut

kosmo integrations:eleven-labs elevenlabs_get_voice '{"voice_id":"example_voice_id"}' --json

eleven-labs.elevenlabs_generate_speech

Write write

Generate speech audio from text using an ElevenLabs voice. Returns base64-encoded audio. Specify a voice ID and model, with optional stability and similarity boost settings.

Parameters
text, voice_id, model_id, stability, similarity_boost

Generic CLI call

kosmo integrations:call eleven-labs.elevenlabs_generate_speech '{"text":"example_text","voice_id":"example_voice_id","model_id":"example_model_id","stability":1,"similarity_boost":1}' --json

Provider shortcut

kosmo integrations:eleven-labs elevenlabs_generate_speech '{"text":"example_text","voice_id":"example_voice_id","model_id":"example_model_id","stability":1,"similarity_boost":1}' --json

eleven-labs.elevenlabs_generate_sound

Write write

Generate a sound effect from a text description using ElevenLabs. Returns base64-encoded audio. Describe the sound you want (e.g., "thunder rumbling in the distance").

Parameters
text, model_id

Generic CLI call

kosmo integrations:call eleven-labs.elevenlabs_generate_sound '{"text":"example_text","model_id":"example_model_id"}' --json

Provider shortcut

kosmo integrations:eleven-labs elevenlabs_generate_sound '{"text":"example_text","model_id":"example_model_id"}' --json

eleven-labs.elevenlabs_list_models

Read read

List available ElevenLabs models. Returns model IDs, names, descriptions, and capabilities. Use this to find the right model for speech or sound generation.

Parameters
limit, page

Generic CLI call

kosmo integrations:call eleven-labs.elevenlabs_list_models '{"limit":1,"page":1}' --json

Provider shortcut

kosmo integrations:eleven-labs elevenlabs_list_models '{"limit":1,"page":1}' --json

eleven-labs.elevenlabs_get_current_user

Read read

Get the current ElevenLabs user profile, subscription tier, and character usage information.

Parameters
none

Generic CLI call

kosmo integrations:call eleven-labs.elevenlabs_get_current_user '{}' --json

Provider shortcut

kosmo integrations:eleven-labs elevenlabs_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

eleven-labs.elevenlabs_list_voices

List available ElevenLabs voices. Returns voice names, IDs, labels, and preview URLs. Use this to discover voices for text-to-speech generation.

Operation
Read read
Schema command
kosmo integrations:schema eleven-labs.elevenlabs_list_voices --json
ParameterTypeRequiredDescription
limit integer no Maximum number of voices to return per page (default: 20).
page integer no Page number for pagination, 1-based (default: 1).

eleven-labs.elevenlabs_get_voice

Get detailed information about a specific ElevenLabs voice by its ID, including name, labels, description, and preview URL.

Operation
Read read
Schema command
kosmo integrations:schema eleven-labs.elevenlabs_get_voice --json
ParameterTypeRequiredDescription
voice_id string yes The unique voice identifier.

eleven-labs.elevenlabs_generate_speech

Generate speech audio from text using an ElevenLabs voice. Returns base64-encoded audio. Specify a voice ID and model, with optional stability and similarity boost settings.

Operation
Write write
Schema command
kosmo integrations:schema eleven-labs.elevenlabs_generate_speech --json
ParameterTypeRequiredDescription
text string yes The text to convert to speech.
voice_id string yes The voice identifier to use for synthesis.
model_id string no The model ID (e.g., "eleven_multilingual_v2"). Defaults to "eleven_multilingual_v2".
stability number no Voice stability (0.0–1.0). Higher values produce more consistent, less expressive output.
similarity_boost number no Similarity boost (0.0–1.0). Higher values make the output closer to the original voice.

eleven-labs.elevenlabs_generate_sound

Generate a sound effect from a text description using ElevenLabs. Returns base64-encoded audio. Describe the sound you want (e.g., "thunder rumbling in the distance").

Operation
Write write
Schema command
kosmo integrations:schema eleven-labs.elevenlabs_generate_sound --json
ParameterTypeRequiredDescription
text string yes Description of the sound effect to generate.
model_id string no The model ID (e.g., "eleven_sound_generation_v1"). Defaults to "eleven_sound_generation_v1".

eleven-labs.elevenlabs_list_models

List available ElevenLabs models. Returns model IDs, names, descriptions, and capabilities. Use this to find the right model for speech or sound generation.

Operation
Read read
Schema command
kosmo integrations:schema eleven-labs.elevenlabs_list_models --json
ParameterTypeRequiredDescription
limit integer no Maximum number of models to return per page (default: 20).
page integer no Page number for pagination, 1-based (default: 1).

eleven-labs.elevenlabs_get_current_user

Get the current ElevenLabs user profile, subscription tier, and character usage information.

Operation
Read read
Schema command
kosmo integrations:schema eleven-labs.elevenlabs_get_current_user --json
ParameterTypeRequiredDescription
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.