Skip to main content

​
1. Overview

The Ana x ElevenLabs integration connects your ElevenLabs account to Ana, giving you natural language access to your voice library, text-to-speech generation history, models, and subscription usage. Once configured, Ana can summarize character consumption, break down generation history by voice or model, and inspect your voice library — all without leaving your workflow.
Connect ElevenLabs to Ana to query and analyze your voice generation activity and usage using natural language.

​
2. Prerequisites

You’ll need:
  • An ElevenLabs account (any paid or free tier with API access)
  • A TextQL account with permission to add API connectors

​
3. Capabilities

Once configured, Ana can:
  • Summarize subscription usage: character quota consumed, remaining credits, and reset dates.
  • Break down text-to-speech generation history by voice, model, and date.
  • List and inspect the voices in your voice library, including labels and settings.
  • Query available models and their capabilities.

​
4. Setup Instructions

​
Step 1: Create your ElevenLabs API key

  1. Go to elevenlabs.io and sign in.
  2. Click Developers in the bottom-left corner of the dashboard.
  3. Select the API Keys tab.
  4. Click + Create Key.
  5. Configure the key:
    • Permissions: select the endpoints Ana should access. At minimum, include User read access (required for the connection test), plus History, Voices, and Models for the capabilities above.
    • Credit limit: optionally set a monthly credit cap to prevent unexpected usage.
  6. Copy the API key immediately — ElevenLabs shows the full key only once, at creation.

​
Step 2: Add ElevenLabs as an API connector in TextQL

  1. Go to app.textql.com and sign in.
  2. In the bottom left sidebar, click Connectors > APIs and select ElevenLabs.
  3. In the configuration panel, fill in the fields:
    • Name (e.g. ElevenLabs)
    • API Key: paste the key copied from Step 1
  4. Click Test to verify the key, then click Save.

​
Step 3: Verify the connection

  1. Go to app.textql.com.
  2. Click on the Elevenlabs connector and select Test Connection at the bottom of the panel.
  • A successful setup will return Connection successful (200).
  • If the test fails, refer to the Troubleshooting section for next steps.

​
5. Usage Examples

Once configured, you can ask Ana:
  • “How much of my ElevenLabs character quota is left this month?”
  • “Break down my TTS generations by voice over the last 30 days.”
  • “Which model did I use most for speech generation this week?”
  • “List the voices in my voice library with their labels.”
  • “When does my ElevenLabs usage quota reset?“

​
6. Troubleshooting

​
7. Security Notes

  • Follow the principle of least privilege: scope the key to only the endpoints Ana needs, and set a credit limit.
  • API keys are shown in full only once. Store them securely and never share them in email, chat, or tickets.
  • Rotate the key if you suspect it has been exposed — keys remain valid until deleted.
  • If you no longer need the integration, delete the key under Developers → API Keys and remove the connector from TextQL.
  • For more details, refer to ElevenLabs’ authentication documentation.

​
Need Help?

For further assistance, please contact support@textql.com.

​
Privacy Policy

For information about how we handle your data and protect your privacy, please review our Privacy Policy.