To get an ElevenLabs API key, sign in at elevenlabs.io, click Developers in the left sidebar, open the API Keys tab and create a key. Copy it straight away, because the full key is shown only once. You do not need a paid plan: ElevenLabs says most API endpoints work on every plan, including Free. This guide covers the setup, a first text-to-speech call, what the API costs per model, the limits on each plan, and the errors you are most likely to hit.
How to Get an ElevenLabs API Key
Step 1: Create an account. Sign up at elevenlabs.io. The Free plan is enough to create a key and test the API. If you may apply for the startup grant later, use your business email, because the grant is applied to the account you apply from.
Step 2: Open the API Keys tab. Click Developers in the left sidebar, then select the API Keys tab. The direct link is elevenlabs.io/app/api/api-keys.
Step 3: Create the key and set its permissions. Keys are restricted by default, so you choose which features the key can access. You can also give each key its own credit limit. Both are worth using: a key that can only call text to speech, with a cap, does little damage if it leaks.
Step 4: Copy it once. The full key is visible only when you create it. Afterwards the dashboard shows the name and the last four characters. If you lose it, delete the key and make a new one.
Step 5: Store it as an environment variable. The ElevenLabs docs use ELEVENLABS_API_KEY.
export ELEVENLABS_API_KEY="your_api_key"
This short video walks through creating a key in the dashboard. Menus move from time to time, so follow the steps above if the layout looks different.
Your First ElevenLabs API Call
ElevenLabs does not use a Bearer token. The key goes in a header named xi-api-key. This curl request turns a sentence into an MP3 using the voice ID from the ElevenLabs quickstart:
curl -X POST "https://api.elevenlabs.io/v1/text-to-speech/JBFqnCBsd6RMkjVDRZzb?output_format=mp3_44100_128" \
-H "xi-api-key: $ELEVENLABS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"text": "The first move is what sets everything in motion.",
"model_id": "eleven_v4"
}' \
--output audio.mp3
And the same request with the official Python SDK, installed with pip install elevenlabs:
import os
from elevenlabs.client import ElevenLabs
client = ElevenLabs(api_key=os.getenv("ELEVENLABS_API_KEY"))
audio = client.text_to_speech.convert(
text="The first move is what sets everything in motion.",
voice_id="JBFqnCBsd6RMkjVDRZzb",
model_id="eleven_v4",
output_format="mp3_44100_128",
)
with open("audio.mp3", "wb") as f:
for chunk in audio:
f.write(chunk)
Set model_id yourself. If you leave it out, the endpoint falls back to eleven_multilingual_v2, not the newest model. To check a key without spending anything, call GET https://api.elevenlabs.io/v1/models with the same header.
Is the ElevenLabs API Free?
Partly. The key costs nothing, and the Free plan includes a small monthly allowance you can spend through the API. As of November 2026 the pricing page lists 10,000 credits a month on Free, which the API pricing page shows as about 10,000 characters, or roughly 10 minutes, of text to speech.
The free allowance comes with three conditions:
- No commercial use. ElevenLabs says the Free plan does not include a commercial license. All paid plans do.
- Attribution. If you publish free-plan audio, you must credit ElevenLabs by including "elevenlabs.io" or "11.ai" in the title.
- No rollover. Unused credits roll over on paid plans, up to twice the monthly quota. On Free they do not.
That makes Free a testing tier. Starter, at $6 a month, is the cheapest plan with a commercial license. If you need a free API for a text model instead, our free AI API comparison lists the providers with real free tiers.
ElevenLabs API Pricing
ElevenLabs sells monthly plans, and each plan includes usage. Its API pricing page quotes rates in US dollars and bills text to speech per character. These are the listed API rates as of November 2026:
| Product | Models | Listed rate |
|---|---|---|
| Text to speech | v4, v3, Multilingual v2 | $0.08 per 1,000 characters |
| Text to speech, real time | v4 Turbo, v3 Conversational, Flash | $0.04 per 1,000 characters |
| Speech to text | Scribe v3, Scribe v2 | $0.20 per hour |
| Speech to text, real time | Scribe v3 Live, Scribe v2 Realtime | $0.22 per hour |
| Voice agents | Speech Engine | $0.08 per minute |
| Music | Eleven Music | $0.15 per minute |
| Sound effects | Sound Effects | $0.12 per minute |
About 1,000 characters is one minute of speech. So an hour of narration, around 60,000 characters, costs about $4.80 on v4 and about $2.40 on a real-time model.
The plan you are on sets how much usage is included each month:
| Plan | Monthly price | Included text to speech at the v4 rate |
|---|---|---|
| Free | $0 | 10,000 characters |
| Starter | $6 | 75,000 characters |
| Creator | $22 | 275,000 characters |
| Pro | $99 | 1,238,000 characters |
| Scale | $299 | 3,738,000 characters |
| Business | $990 | 12,375,000 characters |
| Enterprise | Custom | Custom |
On paid plans the included amount is the plan price divided by the model rate, so the same $6 covers twice as many characters on a $0.04 model. ElevenLabs sometimes discounts the first month of Starter and Creator; check the live page before you subscribe.
The main pricing page describes the same plans in credits instead (10,000 on Free up to 6 million on Business). Plan features, seats and the credit view are on our ElevenLabs pricing page.
When the allowance runs out. New subscriptions can buy Pay As You Go credits, which are used once the monthly quota is gone and last 12 months. Usage-based billing, which older guides describe, is now a legacy option for Enterprise and older Creator, Pro, Scale and Business subscriptions.
Limits on Each Plan
ElevenLabs limits how many requests you can run at the same time, not how many you send per minute. The docs list these concurrency limits:
| Plan | Multilingual v2 | Flash | Speech to text |
|---|---|---|---|
| Free | 2 | 4 | 8 |
| Starter | 3 | 6 | 12 |
| Creator | 5 | 10 | 20 |
| Pro | 10 | 20 | 40 |
| Scale | 15 | 30 | 60 |
| Business | 15 | 30 | 60 |
| Enterprise | Elevated | Elevated | Elevated |
Each model also caps the text in a single request: 10,000 characters on eleven_v4 and eleven_multilingual_v2, 5,000 on eleven_v3, and 40,000 on eleven_flash_v2_5. Split longer scripts into chunks.
One more thing to check in old code: the docs now list eleven_turbo_v2_5 and eleven_turbo_v2 as deprecated, with eleven_flash_v2_5 and eleven_flash_v2 as the replacements.
Common ElevenLabs API Errors
| Error | What it means | Fix |
|---|---|---|
| invalid_api_key (401) | The key is missing or sent incorrectly | Send it in the xi-api-key header and check for typos |
| quota_exceeded (400 or 401) | Not enough quota left for the request | Buy Pay As You Go credits, upgrade, or wait for the monthly reset |
| voice_not_found (400 or 401) | The voice_id is wrong | Copy the ID again from My Voices |
| max_character_limit_exceeded (400) | The text is too long for the model | Split the text into smaller requests |
| too_many_concurrent_requests (429) | You are over your plan's concurrency limit | Queue requests or move up a plan |
| system_busy (429) | ElevenLabs is under heavy traffic | Retry; ElevenLabs says a retry generally succeeds |
Free accounts can also see "Unusual activity detected. Free Tier usage disabled." It is an abuse check aimed at people creating several free accounts, and a VPN or a shared office or mobile IP address can trigger it. ElevenLabs says it cannot reverse the flag. The fixes are a paid plan or an IP address that has not been flagged.
The Startup Grant
If you are building a product on the API, check the ElevenLabs Startup Grants program before you pay for a plan. It gives 33 million characters over 12 months, which ElevenLabs values at more than $5,500 and describes as over 680 hours of Agents usage.
You need fewer than 25 employees, a business or monetization strategy and a valid business email. Agencies, consulting firms and one-off projects are excluded. ElevenLabs says to expect a decision within a week. Eligibility details and common rejection reasons are on our ElevenLabs startup grant page.
Frequently Asked Questions
How do I get an ElevenLabs API key?
Sign in at elevenlabs.io, click Developers in the left sidebar, open the API Keys tab and create a key. Choose which features it can access, then copy it. The full key is shown only once.
Is the ElevenLabs API free?
The key is free and the Free plan includes about 10,000 characters of text to speech a month that you can use through the API. Free-plan audio cannot be used commercially and must be attributed to ElevenLabs.
How much does the ElevenLabs API cost?
As of November 2026, text to speech is listed at $0.08 per 1,000 characters on v4, v3 and Multilingual v2, and $0.04 on v4 Turbo, v3 Conversational and Flash. Paid plans start at $6 a month and include usage.
Where do I put the ElevenLabs API key in a request?
In an HTTP header named xi-api-key. ElevenLabs does not use the Authorization: Bearer format that most AI APIs use. The official SDKs take the key as the api_key argument.
Can I use ElevenLabs API audio commercially on the Free plan?
No. ElevenLabs says the Free plan does not include a commercial license. Every paid plan does, starting with Starter at $6 a month.
What are the ElevenLabs API rate limits?
Limits are on concurrent requests. For Multilingual v2 the docs list 2 on Free, 3 on Starter, 5 on Creator, 10 on Pro and 15 on Scale and Business. Flash models allow double. Going over returns a 429 error.
Why does my ElevenLabs API key return quota_exceeded?
Your account, or the credit limit set on that key, does not have enough quota left for the request. Buy Pay As You Go credits, upgrade the plan, raise the limit on the key, or wait for the monthly reset.
Do startups get free ElevenLabs API usage?
Yes, through the Startup Grants program: 33 million characters over 12 months for companies with fewer than 25 employees, a monetization strategy and a business email. Applications are reviewed.
Next Steps
Create a restricted key on the Free plan, run the curl example and listen to the result. Before you ship, move to a paid plan for the commercial license, or apply for the grant on our ElevenLabs page. A voice product usually needs a text model as well, so see our guides to the OpenAI API key and the Grok API, and compare plans on the ElevenLabs pricing page.