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
- Go to elevenlabs.io and sign in.
- Click Developers in the bottom-left corner of the dashboard.
- Select the API Keys tab.
- Click + Create Key.
- 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.
- Copy the API key immediately — ElevenLabs shows the full key only once, at creation.
Step 2: Add ElevenLabs as an API connector in TextQL
- Go to app.textql.com and sign in.
- In the bottom left sidebar, click Connectors > APIs and select ElevenLabs.
- In the configuration panel, fill in the fields:
- Name (e.g.
ElevenLabs) - API Key: paste the key copied from Step 1
- Name (e.g.
- Click Test to verify the key, then click Save.
Step 3: Verify the connection
- Go to app.textql.com.
- On the bottom left sidebar click Connectors → APIs and check that ElevenLabs appears in your list of active connectors.
- Open a new Ana chat and ask a simple query, such as: “How many characters have I used this month on ElevenLabs?”
- If Ana returns results, the connection is working. If you see an error, refer to Section 6: Troubleshooting.
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
| Symptom | Likely Cause | Fix |
|---|---|---|
| Test fails with 401 | Invalid, revoked, or incorrectly copied API key | Create a new key under Developers → API Keys and update the connector in TextQL. |
| Test fails despite a valid key | The key’s permissions exclude the User endpoint (the connection test calls /v1/user) | Edit the key’s permissions in ElevenLabs to include User read access, or create a new key with it. |
| 401 on specific queries only | The key is scoped to a subset of endpoints | Add the missing endpoint permissions (History, Voices, Models) to the key. |
| Quota errors (429) | The key’s monthly credit limit is exhausted | Raise the key’s credit limit or wait for the monthly reset. |
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.