PolyCog Try it free
0 of 5 done
Key guide · ElevenLabs · verified Sep 27, 2026

How to get an ElevenLabs API key for AI voices and text to speech

About eight minutes and $10. Make an ElevenLabs account, add $10 of prepaid credit on top of the free plan, and create a key that can read text aloud and list your voices. Nothing renews, and the credit lasts a year. Works with any app that asks for an ElevenLabs key, or with your own code.

The short version: elevenlabs.io, Sign up (Google, or email + a verification link, then sign in again), five welcome screens (Skip the plans), then Subscription › ElevenAPI › + Add credits: $10 (it starts at $20), Top up, pay on Stripe, Maybe later on Auto Top Up. Then ElevenAPI › API Keys › + Create Key: name it after the app, Restrict Key stays on (every endpoint starts at No Access): Text to Speech: Access, Voices: Read, plus whatever else the app needs, Per credit refresh period left empty. Copy to Clipboard (sk_, shown once). Test it with GET /v2/voices (free) and POST /v1/text-to-speech/voice_id, the key in the xi-api-key header.

PolyCog doesn't use ElevenLabs any more. Its read-aloud voices run on your xAI key now. This guide stays up for anyone setting up an ElevenLabs key for another app or their own code.
Never made an API key? Stay here. Every click is spelled out. Condensed steps, direct links, scopes and tier details.

What you need

  • An email address, or a Google account
  • A card: $10 of prepaid credit, plus sales tax where it applies
  • The app or code the key is for: its setup page should say which permissions it needs
  • About eight minutes
  • For the test in step 5: PowerShell (Windows) or Terminal (Mac), both already on your computer

A new key can't do anything until you switch two things on

ElevenLabs starts every new key with Restrict Key on and every permission set to No Access. Choose Create Key straight away and every request fails with "missing the permission". Step 3 switches on the two that reading text aloud needs, Text to Speech and Voices: Read, and lists the rest.

The steps

Tick each circle as you finish a step. Your ticks stay in this browser, so you can close the tab and pick up where you left off.

Make an ElevenLabs account

3 min

Go to elevenlabs.io and choose Sign up. The quickest way in is Sign up with Google. To use an email address instead, type it and a password (at least 8 characters with a number and a special character), tick the box that agrees to the terms, and choose Sign up. ElevenLabs emails you a link: choose Verify email, then sign in once more with the same email and password to finish. Five short screens follow. Pick either platform (it doesn't matter for the key), tick the box that says you're 18 or older, and choose Skip on the rest. The last one offers paid plans: you don't need one, so choose Skip.

Email, Password
yours, then tick the terms box (or Sign up with Google)
Verify your email for ElevenLabs
the Verify email button, then sign in again
Choose your platform
either one (the key lives in a third, ElevenAPI)
Help us personalize your experience
tick the 18 or older box; the rest is optional
Do more with ElevenLabs
Skip (no plan needed)
Illustrationelevenlabs.io (simplified)
ElevenLabsLog in Bringing
technology to life
From ElevenAgents for customer experience, ElevenCreative for content creation, to the leading AI voice generator. Sign upContact sales ElevenCreativeElevenAgentsElevenAPI
Verify your email for ElevenLabs ElevenLabs <no-reply@…> · Inbox Verify email →
1/8Choose Sign up
  • The email comes from ElevenLabs <no-reply@…> with the subject "Verify your email for ElevenLabs". In our test it reached the inbox within a minute. If it doesn't, check Spam, or choose Resend once its countdown ends.
  • After Verify email, ElevenLabs asks you to sign in once more. That's normal: it's how the verification finishes.
  • ElevenCreative or ElevenAgents: pick either. The key lives in a third platform, ElevenAPI, and step 3 goes straight there.
  • The plan screen at the end is optional. Skip keeps you on the Free plan; step 2 adds credit instead.
  • elevenlabs.io › Sign up (/app/sign-up): Google, or email + password (8+ characters, a number, a special character) + the terms and voice-data consent box › a link from no-reply@… ("Verify your email for ElevenLabs"), resend after 60 s › sign in again to complete verification (sign-in also offers Apple and SSO) › /app/onboarding, five screens: Choose your platform (ElevenCreative / ElevenAgents) · name (optional), language, how you heard (optional), the 18+ box · "Which one describes you" (Skip) · "What would you like to do" (Skip) · plans: Starter $6, Creator $11 the first month then $22, Pro $99 (Skip). Lands on the Free plan, 10,000 credits a month.
Open the sign-up page ↗

Add $10 of prepaid credit

Required2 min

Choose the round profile button (top right), then Subscription, and the ElevenAPI tab (or use the link below). Under Credits used, choose + Add credits. Top up by starts at $20: tap $10 (the smallest amount it accepts). Choose Add credits, then Top up on the box that suggests a monthly plan. Pay on the Stripe page (card, name, billing address). Back on ElevenLabs, a box offers Auto Top Up: choose Maybe later. You stay on the free plan, now shown as Pay as you go.

Illustrationelevenlabs.io/app/subscription/api (simplified)
Subscription ElevenCreativeElevenAgentsElevenAPI Credits used0 credits / 10,000 credits Subscribe from $6/mo+ Add credits You're currently on Free plan⚙ Billing Starting at $6/month, subscribe to get higher concurrency, higher audio quality, and voice cloning. You can still top up anytime. Model Pricing Flash / Turbo$0.04 per 1K charactersv2 Multilingual$0.08 per 1K charactersv3$0.08 per 1K characters Add credits Top up by$3.64 = 10,000 credits $20 $10$20$50 Credits remaining$0Top up credits$20Credits after top up$20 Sales tax, VAT, or other indirect taxes may be added to the charge according to your local regulations. CancelAdd credits Before you top up Adding credits will reduce some of your free usage quotas and give you better API pricing. For better value and features like voice cloning, higher audio quality, and increased concurrency, consider subscribing to a monthly plan. You can still top up anytime. Explore plansTop up Billing This workspace is on Pay as you go. Credits remaining37,472 / 37,472 Next payment amount$0 SecurityEnable 2FA to prevent abuse of account fundsSet up 2FA Never run out of credits Automatically add credits when your balance gets low. You choose the amount and threshold. Maybe laterConfigure Auto Top Up
Successfully added 27,472 credits
1/7Subscription, the ElevenAPI tab
  • $10 is the smallest top-up (it bought 27,472 credits in our Sep 27 test), plus sales tax where it applies ($10.98 in our US test). The free plan's monthly allowance is used first. What $10 reads aloud is below.
  • Over the API, ElevenLabs refuses most Voice Library voices to free accounts with no credit, and can switch them off when they're used from a cloud server. Credit avoids both: our test account worked fine once it had credit.
  • Auto Top Up is off unless you switch it on. Its form pre-fills "top up by $20 when the balance drops below $10", with a monthly spend cap you can leave blank. Leave it off and the $10 is the most a key can ever spend.
  • Credit lasts 12 months. At zero, requests stop: there's no bill afterwards.
  • ElevenLabs suggests two-step verification "to prevent abuse of account funds". It's worth switching on.
  • Subscription › ElevenAPI (/app/subscription/api): Credits used 0 / 10,000 · Subscribe from $6/mo · + Add credits · Billing. Add credits: Top up by (pre-filled $20, chips $10 / $20 / $50, "$3.64 = 10,000 credits"), Credits remaining / Top up credits / Credits after top up, a tax note › "Before you top up: Adding credits will reduce some of your free usage quotas and give you better API pricing" (Explore plans / Top up) › Stripe Checkout "Prepaid credits": card, cardholder name, billing address › back with "Successfully added N credits" and "Never run out of credits" (Maybe later / Configure Auto Top Up). Billing then reads "This workspace is on Pay as you go", Next payment amount $0.
  • Auto Top Up: off; Top up by $20 when the balance drops below $10 ("Top-ups may take up to 5 minutes"), Monthly spend cap (blank = no limit). Prepaid credit expires 12 months after purchase; nothing is billed after it runs out. Plans: Starter $6 (30k credits), Creator $11 the first month then $22, Pro $99 (600k). Model prices on Oct 19, 2026 (elevenlabs.io/pricing/api): Flash / Turbo and v4 Turbo $0.04 per 1K characters; v4, v3 and v2 Multilingual $0.08.
Open Subscription › ElevenAPI ↗

Make a key and copy it

2 min

At the bottom of the left menu, choose Switch beside the platform name and pick ElevenAPI, then choose API Keys under Configure (or use the link below). Choose + Create Key. Name it after the app that will use it and leave Expire After on Never. Restrict Key is on and every endpoint starts at No Access: to read text aloud, set Text to Speech to Access, then scroll down and set Voices to Read. Switch on anything else your app needs (the table below), leave the rest alone, and leave Per credit refresh period empty (Unlimited): your balance is already the limit. Choose Create Key, then Copy to Clipboard before you close the box.

A key made without changing anything can't read aloudElevenLabs starts every new key with Restrict Key on and every endpoint set to No Access. If you choose Create Key straight away, every request gets "missing the permission text_to_speech". Set the switches first.
Illustrationelevenlabs.io/app/voice-library (simplified)
ElevenLabs Home Build Voices API Playground Configure API Keys Billing Monitor Analytics Request Log ElevenCreativeSwitch Voices ExploreMy Voices ⌕ Search library voices… HaleExpressiveBrianRelatableSavvyWarm
ElevenCreativeElevenAgentsElevenAPI Create API Key Name  Expire AfterNever Restrict Key Usage Limits (Credits) Per credit refresh periodUnlimited Endpoints Text to SpeechNo AccessAccess Speech to SpeechNo AccessAccess Speech to TextNo AccessAccess Sound EffectsNo AccessAccess Music GenerationNo AccessAccess DubbingNo AccessReadWrite ElevenAgentsNo AccessReadWrite Audio NativeNo AccessReadWrite VoicesNo AccessReadWrite Voice GenerationNo AccessAccess Forced AlignmentNo AccessAccess Ads EngineNo AccessReadWrite Administration HistoryNo AccessReadWrite ModelsNo AccessAccess UserNo AccessAccess … Workspace, Webhooks, Service Accounts and more Restrict by IP address Auto-disable if leakedIf the key is detected as publicly exposed, ElevenLabs will attempt to automatically disable it. CancelCreate Key API Key – My app ⓘ This is your new API key. Make sure to copy it before closing this dialog as it won't be displayed again! API Key sk_f0e1••••••••••••••••••••••••••••9c3d Copy to Clipboard API key copied to clipboard.
1/8Bottom left: Switch, then ElevenAPI
You only see it onceThe key starts with sk_. Paste it straight into your app or a password manager (next step). Lost it? Make another with Create Key and delete the old one. Anyone with the key can spend your credit.
  • Text to Speech turns text into audio. Voices: Read lets an app list your voices so you can pick one. Neither can clone, change or delete anything.
  • Got a switch wrong? The key's ⋯ › Edit changes its permissions later, and there's nothing to paste again. Hover the ⓘ next to its name to see what it can do.
  • Leave Restrict by IP address off unless the key only ever runs on a server with a fixed address, and leave Auto-disable if leaked on (both are the defaults).
What else your app might need
If your app…Switch on
reads text aloudText to Speech: Access
lets you pick from your voicesVoices: Read
clones or edits voicesVoices: Write
turns speech into textSpeech to Text: Access
makes sound effectsSound Effects: Access
shows your remaining creditUser: Access

The app's own setup page should say which it needs. Names as ElevenLabs showed them on Sep 27, 2026.

  • ElevenAPI › Configure › API Keys › + Create Key (/app/api/api-keys, a side panel): Name · Expire After (15 minutes / 1 hour / 1 day / 7 days / 30 days / Never, the default) · Restrict Key (on by default) · Usage Limits (Credits): Per credit refresh period (a plain number box, Unlimited when empty) · Endpoints, all No Access by default: Text to Speech, Speech to Speech, Speech to Text, Sound Effects, Audio Isolation, Music Generation, Image & Video Generation (No Access / Access), Dubbing, ElevenAgents, Projects, Audio Native, Voices, Ads Engine, History, Pronunciation Dictionaries, Workspace (No Access / Read / Write), Voice Generation, Forced Alignment, Models, User, Workspace Analytics, Webhooks, Service Accounts, Group Members, Workspace Members, Terms of Service Accept · Restrict by IP address (off) · Auto-disable if leaked (on) › Create Key › "API Key – <name>": sk_ + 48 hex, "won't be displayed again" › Copy to Clipboard. Reading text aloud needs text_to_speech; listing voices needs voices_read.
  • The list shows NAME (ⓘ = its permissions), KEY (last four), CREATED, EXPIRES and an ENABLED switch; ⋯ offers Edit (Save Changes), Copy Key ID and Delete. Restrict by IP address takes addresses or CIDR ranges; a request from anywhere else gets a 403, so leave it off for a desktop or phone app whose address changes. These are user keys; Service Accounts aren't needed for one person's app.
Open API Keys directly ↗

Put it where it'll be used

1 min

Paste the key into the app that asked for it. It's usually under Settings, API keys or Integrations, in a box labelled ElevenLabs. Writing your own code? Keep the key out of the code itself: store it in an environment variable named ELEVENLABS_API_KEY (the name ElevenLabs' own quickstart uses) and read it from there. Every request sends it in a header called xi-api-key.

Never put the key in a web page's codeAnyone who opens the page can read it and spend your credit. If ElevenLabs finds a key leaked in public it switches it off by itself: that's the Auto-disable if leaked switch you left on in step 3.
  • Keep a copy in a password manager. ElevenLabs never shows the key again, and a new one is free to make.
  • One key per app. If one leaks or misbehaves, you switch off that key alone.
  • Header xi-api-key: sk_… on every request to https://api.elevenlabs.io. The SDKs and ElevenLabs' quickstart read ELEVENLABS_API_KEY. A browser or phone app that talks to ElevenLabs directly should get a short-lived single-use token from your server (ElevenLabs' docs: Tokens), never the key itself. A key locked with Restrict by IP address answers 403 from any other address.

Test it

2 min

Two copy-paste commands check the key from your own computer. The first lists your voices and costs nothing. The second turns one sentence into an MP3 file, using about 33 characters of credit. On Windows open PowerShell (Start, then type PowerShell); on a Mac open Terminal. Paste each line and press Enter.

Windows: PowerShell

  1. Put your key in this window. Replace the placeholder with your key; the window forgets it when you close it.
    $env:ELEVENLABS_API_KEY = "paste-your-key-here"
  2. List your voices. A list of names means the key works and can read your voices. Free.
    (Invoke-RestMethod https://api.elevenlabs.io/v2/voices -Headers @{ "xi-api-key" = $env:ELEVENLABS_API_KEY }).voices.name
  3. Make hello.mp3 in the folder the window is in (your user folder unless you moved). About 33 characters of credit.
    Invoke-RestMethod "https://api.elevenlabs.io/v1/text-to-speech/JBFqnCBsd6RMkjVDRZzb" -Method Post -Headers @{ "xi-api-key" = $env:ELEVENLABS_API_KEY } -ContentType "application/json" -Body '{"text": "Hello from my new ElevenLabs key.", "model_id": "eleven_flash_v2_5"}' -OutFile hello.mp3

Mac or Linux: Terminal

  1. Put your key in this window. Replace the placeholder with your key; the window forgets it when you close it.
    export ELEVENLABS_API_KEY="paste-your-key-here"
  2. List your voices. Text that starts with {"voices" means the key works and can read your voices. Free.
    curl -s https://api.elevenlabs.io/v2/voices -H "xi-api-key: $ELEVENLABS_API_KEY" | head -c 400; echo
  3. Make hello.mp3 in the folder the window is in (your home folder unless you moved). About 33 characters of credit.
    curl -s -X POST "https://api.elevenlabs.io/v1/text-to-speech/JBFqnCBsd6RMkjVDRZzb" -H "xi-api-key: $ELEVENLABS_API_KEY" -H "Content-Type: application/json" -d '{"text": "Hello from my new ElevenLabs key.", "model_id": "eleven_flash_v2_5"}' -o hello.mp3
  • If hello.mp3 plays, the key can read aloud, and your app will work with it once it has the same permissions.
  • Red text in PowerShell, or text that starts with {"detail" on a Mac, is an error. Find its words under Troubleshooting. On a Mac a failed second command still makes hello.mp3, holding the error instead of sound: open it in a text editor to read it.
  • The voice in the second command is one of ElevenLabs' default voices, the one their own API reference uses. Any voice_id from the first command's list works in its place.
  • GET /v2/voices needs voices_read (the older GET /v1/voices is in ElevenLabs' Legacy section); the reply is {"voices": [{"voice_id", "name", …}], "has_more", "total_count", "next_page_token"}. POST /v1/text-to-speech/{voice_id} needs text_to_speech; model_id defaults to eleven_multilingual_v2 and output_format to mp3_44100_128. ElevenLabs' authentication page tests a key with GET /v1/models, which a key restricted the way step 3 makes it refuses (Models stays on No Access). Every call shows in ElevenAPI's Request Log. Errors are JSON: {"detail": {"status", "message"}}, mostly HTTP 401.

What $10 of credit reads aloud

ElevenLabs charges per character of text, and the price depends on the voice model. Its own rule of thumb: 1,000 characters is about a minute of audio.

Voice modelPriceper 1,000 charactersA 500-word answerabout 3,000 characters$10 reads about
Flash v2.5, v4 Turbothe fastest and cheapest$0.04≈ $0.12250,000 characters · about 4 hours
v4, v3, Multilingual v2the most expressive$0.08≈ $0.24125,000 characters · about 2 hours

Prices read from ElevenLabs' pricing page on Oct 19, 2026. A top-up is bought in dollars and spent as credits; ElevenAPI's Request Log shows what each request used.

Ways to pay ElevenLabsPriceIncludedNotes
Free plan$010,000 characters a month (20,000 on Flash)About 10 to 20 minutes. Over the API, free accounts can't use most Voice Library voices: see step 2.
Prepaid creditPay as you gofrom $10Spent at the prices aboveOn top of the free plan's. Lasts 12 months. Stops at zero. Plus sales tax where it applies ($10.98 in our US test).
Starter plan$6 a month75,000 characters a month (150,000 on Flash)Renews monthly. Adds a commercial licence and instant voice cloning.

Plans from ElevenLabs' API pricing page on Oct 19, 2026; prepaid credit as walked on Sep 27, 2026.

Troubleshooting

Find the words from the error your app shows, or from the commands in step 5. ElevenLabs' errors arrive as JSON: a detail with a status and a message.

The API key you used is missing the permission text_to_speech to execute this operation.401 · missing_permissions
  • The most common one. ElevenLabs starts every new key with Restrict Key on and every endpoint on No Access, so a key made without changing anything can't do anything. On API Keys, choose the key's ⋯, then Edit, switch on what the message names and choose Save Changes. The key itself doesn't change, so there's nothing to paste again. Hover the ⓘ next to a key's name to see what it can do.
  • The message names the permission in its API spelling: text_to_speech is Text to Speech, voices_read is Voices: Read. Step 3 has a table of what else an app might need.
Invalid API key401 · invalid_api_key

ElevenLabs doesn't recognise the key: a character went missing or extra text got in when you pasted it, the key was deleted, or its Enabled switch on API Keys is off. Wherever you pasted it, select everything in the box and delete it, then paste again. A key is 51 characters: sk_ and 48 letters and numbers. If that doesn't fix it, make a new key (step 3): ElevenLabs shows a key only once.

This request exceeds your quota of …. You have … credits remaining, while … credits are required for this request.401 · quota_exceeded
  • Your account is out of credit: the free plan's monthly credits and your prepaid balance are both used up, or too low for this answer. Top up on Subscription › ElevenAPI › + Add credits (step 2), or wait for the free credits to renew.
  • A long request needs more credits than a short one, so a short line can still work when a long one can't.
  • If the message says "your API key (the key's name) quota", it's the key's own limit, not your account: see the next item.
This request exceeds your API key (…) quota of …. You have … credits remaining, while … credits are required for this request.401 · quota_exceeded, the key's own limit

The key has spent the number typed into Per credit refresh period when it was made, even if your account still has credit (the message names the key). On API Keys, choose the key's ⋯, then Edit, raise the number or clear it, and choose Save Changes.

Free users cannot use library voices via the API. Please upgrade your subscription to use this voice.a free account with no credit

ElevenLabs keeps most Voice Library voices for paying accounts when they're used from an app. Add prepaid credit or pick a paid plan (step 2). With $10 of credit on the free plan, our test account used ElevenLabs' default voices without a problem.

Unusual activity detected. Free Tier usage disabled.401 · a free account used from a server

ElevenLabs' abuse check sometimes switches off free accounts that are used from a shared or data-centre address: an app that calls ElevenLabs from a cloud server, or a VPN, can trip it. ElevenLabs says it can't undo the flag; prepaid credit or any paid plan avoids it (step 2).

A voice with the voice_id … was not found.404 · voice_not_found

The voice isn't on your ElevenLabs account any more: it was deleted there, or it's a Voice Library voice that was never added. In ElevenLabs, open the voice and add it to My Voices, or pick another voice in your app. The first command in step 5 lists every voice your key can use, with its voice_id.

Too many concurrent requests · System busy429 · a rate limit

Each ElevenLabs plan can run only a few voice requests at once, and the free plan has the fewest. Send fewer at the same time (another app on the same account counts too), wait a few seconds and try again, or move to a plan with more.

ElevenLabs is down, or didn't answer500 · 503 · a timeout

It isn't your key or your credit. Try again shortly; a very long request on a slow day can also run out of time, so try a shorter one. status.elevenlabs.io shows ElevenLabs' incidents.

Model not found · unsupported model400 · 404 · model_not_found
  • The model_id in the request isn't one ElevenLabs serves. Its text to speech models today are eleven_v4, eleven_v4_turbo, eleven_v3, eleven_v3_conversational, eleven_multilingual_v2, eleven_flash_v2_5 and eleven_flash_v2; eleven_turbo_v2_5 and eleven_turbo_v2 are deprecated in favour of the Flash models. ElevenLabs' models page keeps the current list.
  • In someone else's app there's nothing to fix on your side: the app has to move to a current model. Tell its maker.
Where's my key?closed the box before copying

ElevenLabs shows a key only once. On API Keys, choose + Create Key, make another one the same way (step 3), and copy it this time. Then delete the one you lost from its ⋯ menu. A new key costs nothing.

ElevenLabs charged my card againauto top-up or a plan renewal

Either Auto Top Up is on, or you're on a monthly plan, which renews each month. Auto Top Up is off until you switch it on; its form pre-fills "top up by $20 when the balance drops below $10", with an optional monthly spend cap. Switch it off under Subscription › Billing, and cancel a plan there too (you keep it to the end of the month). Invoices are there and in your email.

Questions people ask

What is ElevenLabs?

ElevenLabs makes AI voices that sound close to human. Its API turns text into speech (and speech into text, sound effects and more) for any app that holds your key. You pay ElevenLabs at its own prices.

Is ElevenLabs free?

There's a free plan: 10,000 characters a month on the v4 voices, or 20,000 on Flash and v4 Turbo (about 10 or 20 minutes of audio). But over the API, free accounts can't use most Voice Library voices, and ElevenLabs sometimes blocks free accounts used from shared servers. That's why this guide adds a little prepaid credit.

A plan or prepaid credit?

Prepaid credit if you only need a little: you pay once ($10 minimum), it lasts a year, and nothing renews. The Starter plan is $6 a month for 75,000 characters on v4 (150,000 on Flash), renews every month, and adds a commercial licence and instant voice cloning. Plan credits are used first, then prepaid.

Can I use my own cloned voice?

Yes. Make the clone in ElevenLabs (instant cloning needs the Starter plan or above) and it gets a voice_id like any other voice. An app that lists your voices (Voices: Read) shows it; in your own code, pass its voice_id.

Does ElevenLabs credit expire?

Prepaid credit lasts 12 months from purchase. A plan's monthly credits roll over for up to two months while you stay subscribed, and are lost if you cancel or downgrade. Refunds: within 14 days, and only if none of that payment's credit was used.

How do I keep the key safe?

Give each app its own key, switched on only for what it needs (step 3), so one leak never has the run of your account. Keep keys out of web pages and public code: a server or an environment variable is the place. With Auto Top Up off, the credit you bought is the most a key can ever cost. ElevenLabs switches a key off by itself if it's found leaked in public, and you can switch it off or delete it on API Keys at any time.

PolyCog's key guides

Comparing AI answers too?

PolyCog puts up to six AI models on the same question, lets them debate, and has the one you pick write the answer. Your keys, provider prices, no markup.

Free tier forever · $10/mo · $250 lifetime · your API keys, your bill

Verified at ElevenLabs' help center, developer docs and platform on Sep 27, 2026. ElevenLabs moves things around; spotted a change? Send a correction. Screens are simplified drawings, not screenshots. Not affiliated with ElevenLabs. All guides → · Models → · Pricing →