ElevenLabs Connector

The ElevenLabs connector integrates Agentcy with the ElevenLabs text-to-speech platform. It provides 4 live tools for generating speech, browsing voices, and monitoring usage.

Authentication

The connector authenticates using an ElevenLabs API key, which you can generate at elevenlabs.io/app/settings/api-keys.

{
  "name": "ElevenLabs",
  "source_type": "elevenlabs",
  "config": {
    "api_key": "sk_..."
  }
}

Variable	Required	Description
api_key	Yes	ElevenLabs API key

Live Tools (4)

Tool	Description	Arguments
elevenlabs_text_to_speech	Convert text to speech audio	text, voice_id?, model_id?, output_format?
elevenlabs_list_voices	List available voices (premade and custom)	category?
elevenlabs_get_voice_settings	Get settings for a specific voice	voice_id
elevenlabs_get_usage	Get current usage and quota information	--

Example: Agent Using ElevenLabs Tools

User: "What voices are available for narration?"

Agent: Let me list the available voices.
→ Calls elevenlabs_list_voices()
→ Returns: "Found 24 voices:
  - Rachel (premade, female, American, narrative)
  - Adam (premade, male, American, conversational)
  - Bella (custom, female, British, narrative)
  ..."

User: "Generate an audio clip saying 'Welcome to Agentcy' with Rachel's voice"

Agent: I'll generate the audio.
→ Calls elevenlabs_text_to_speech(text: "Welcome to Agentcy", voice_id: "21m00Tcm4TlvDq8ikWAM")
→ Returns: audio file URL / binary data
→ Reports: "Audio generated successfully using Rachel's voice (MP3, 2.1s)."

ETL Ingestion

This connector does not support ETL ingestion. All tools operate as live API calls to the ElevenLabs platform.

Configuration Reference

{
  "name": "ElevenLabs",
  "source_type": "elevenlabs",
  "config": {
    "api_key": "sk_..."
  }
}

Field	Type	Default	Description
api_key	string	required	ElevenLabs API key

Troubleshooting

Error	Cause	Fix
401 Unauthorized	Invalid API key	Verify the API key at elevenlabs.io/app/settings/api-keys
Quota exceeded	Character quota exhausted for the billing period	Upgrade your ElevenLabs plan or wait for quota reset
Voice not found	Invalid voice_id	Use elevenlabs_list_voices to find valid voice IDs
Invalid text	Text is empty or exceeds the character limit	Keep text within the plan's character limit per request
Rate limited	Too many concurrent requests	Add delays between requests or upgrade your plan