Resumo / Pontos-chave
- Crie uma chave em elevenlabs.io/app/settings/api-keys e envie-a no cabeçalho xi-api-key.
- As chaves podem ser limitadas por escopo de endpoint, cota de créditos, lista de permissão de IP e expiração.
- O custo de Text to speech é de $0,08 por 1.000 caracteres (v4, v3, Multilingual v2) ou $0,04 (Turbo, Flash), em todos os planos.
- A concorrência é limitada por plano: 2 solicitações de Multilingual v2 no plano Free, chegando a 15 nos planos Scale e Business.
- O plano Free inclui 10.000 caracteres v4 de fala via API por mês.
Resposta curta: para obter uma chave de API do ElevenLabs, faça login, abra suas configurações de chaves de API, crie uma chave e copie-a, depois envie-a no cabeçalho xi-api-key. A API de conversão de texto em fala custa $0,08 por 1.000 caracteres no Eleven v4, v3 e Multilingual v2, e $0,04 nos modelos Turbo e Flash, com a mesma taxa em todos os planos. O plano Free inclui 10.000 caracteres v4 por mês.
Como verificamos: as etapas de configuração vêm da documentação de início rápido, autenticação de API e chaves de API do ElevenLabs; preços e limites da página de preços da API e da documentação de modelos. Tudo verificado em elevenlabs.io em 1º de novembro de 2026. Alguns links são links de afiliados: se você se inscrever, o ElevenLabs pode nos pagar uma comissão sem custo adicional para você.
Como criar uma chave de API do ElevenLabs
- 1. Crie uma conta ou faça login no ElevenLabs. Uma conta Free é suficiente para obter uma chave.
- 2. Abra a página de chaves de API. Vá para suas configurações de chaves de API pessoais (também vinculadas a partir da seção de Desenvolvedores do painel).
- 3. Crie uma chave. Dê a ela um nome que você reconhecerá mais tarde.
- 4. Defina restrições (opcional). Limite quais endpoints ela pode chamar, defina uma cota de crédito, adicione uma lista de permissões de IP ou escolha uma expiração de 15 minutos a 30 dias (o padrão é nunca).
- 5. Copie e armazene-a como um segredo, por exemplo
ELEVENLABS_API_KEY=...em um arquivo.env. Nunca a coloque no código do navegador ou do aplicativo. - 6. Instale um SDK:
pip install elevenlabspara Python ounpm install @elevenlabs/elevenlabs-jspara JavaScript. - 7. Faça uma chamada de teste.
curl https://api.elevenlabs.io/v1/models -H "xi-api-key: $ELEVENLABS_API_KEY"retorna os modelos que sua chave pode usar.
O ElevenLabs também documenta um atalho para agentes de codificação: executar npx -y @elevenlabs/cli@latest onboard init faz login através do navegador, cria uma chave e a salva no arquivo env do seu projeto.
Regras de chave de API que vale a pena conhecer
- Dois tipos de chave. As chaves de usuário pertencem a uma pessoa e precisam de um Full Seat no workspace. As chaves de conta de serviço pertencem ao workspace e são adequadas para backends de produção; elas estão disponíveis em planos com vários assentos e não expiram.
- Restrições. Cada chave pode ser limitada a endpoints específicos, receber um limite de crédito e ser bloqueada para até 100 endereços IP públicos ou intervalos. Solicitações de outros IPs recebem um erro 403.
- Expiração. As chaves de usuário podem expirar automaticamente; uma chave expirada retorna 401.
- Vazamentos. O ElevenLabs participa do programa de verificação de segredos do GitHub. Uma chave enviada para um repositório público é desativada automaticamente (por padrão em planos não Enterprise) e deve ser rotacionada.
- Aplicativos do lado do cliente. Para conexões de navegador, o ElevenLabs oferece tokens de uso único de curta duração para que a chave real nunca saia do seu servidor.
Preços da API do ElevenLabs por modelo
| Model | Price per 1,000 characters | Max characters per request | Languages |
|---|---|---|---|
| Eleven v4 | $0.08 | 10,000 | 90+ |
| Eleven v4 Turbo | $0.04 | not stated | 90+ |
| Eleven v3 | $0.08 | 5,000 | 70+ |
| Eleven v3 Conversational | $0.04 | not stated | 70+ |
| Multilingual v2 | $0.08 | 10,000 | 29 |
| Flash / Turbo (v2.5) | $0.04 | 40,000 | 32 |
O uso da API é cobrado em dólares americanos, não em créditos. A taxa do seu plano funciona como gasto de API incluído, portanto, os caracteres incluídos são o preço do plano dividido pela taxa do modelo:
| Plan | Price | v4 / v3 / v2 characters | Turbo / Flash characters | Scribe v2 hours |
|---|---|---|---|---|
| Free | $0 | 10,000 | 20,000 | 4.5 |
| Starter | $6 | 75,000 | 150,000 | 27 |
| Creator | $22 | 275,000 | 550,000 | 100 |
| Pro | $99 | 1,238,000 | 2,475,000 | 450 |
| Scale | $299 | 3,738,000 | 7,475,000 | 1,359 |
| Business | $990 | 12,375,000 | 24,750,000 | 4,500 |
Outros produtos de API: transcrição Scribe v2 $0,22 por hora de áudio ($0,39 em tempo real), música $0,15 por minuto, efeitos sonoros, Voice Changer e Voice Isolator $0,12 por minuto, Dubbing v1 $0,33 por minuto com marca d'água ($0,50 sem), Dubbing v2 $2,20 por minuto. Após o limite do seu plano, novas contas fazem pagamentos antecipados com recargas Pay As You Go a partir de $5. Você pode acompanhar o uso na aba Analytics do painel de Desenvolvedores.
Limites de taxa e simultaneidade por plano
A ElevenLabs limita quantas solicitações são executadas ao mesmo tempo, não quantas você envia por minuto. Solicitações acima do limite aguardam em uma fila, o que a ElevenLabs afirma adicionar normalmente cerca de 50ms.
| Plan | Multilingual v2 | Flash | Speech to text | Realtime STT | Music |
|---|---|---|---|---|---|
| Free | 2 | 4 | 8 | 6 | 0 |
| Starter | 3 | 6 | 12 | 9 | 2 |
| Creator | 5 | 10 | 20 | 15 | 2 |
| Pro | 10 | 20 | 40 | 30 | 2 |
| Scale | 15 | 30 | 60 | 45 | 5 |
| Business | 15 | 30 | 60 | 45 | 5 |
| Enterprise | Elevated | Elevated | Elevated | Elevated | Highest |
A documentação observa que um limite de simultaneidade de 5 pode normalmente atender cerca de 100 fluxos de áudio simultâneos, porque cada solicitação é curta. No WebSocket de conversão de texto em fala, apenas o tempo gasto gerando áudio conta para o limite. As respostas carregam os cabeçalhos current-concurrent-requests e maximum-concurrent-requests para que você possa monitorá-lo. Uma ressalva: a comparação de planos na página de preços lista 25 solicitações simultâneas para o plano Business, enquanto a tabela da documentação diz 15.
Limites de caracteres por solicitação
Cada solicitação de conversão de texto em fala tem um comprimento máximo: 10.000 caracteres no Eleven v4 e Multilingual v2, 5.000 no v3, 40.000 no Flash v2.5 e 30.000 no Flash v2. Divida scripts mais longos em partes.
Gostando do artigo? Receba um assim na sua caixa de entrada toda manhã.
um e-mail por dia · cancele em dois cliques · sem rastreadores de terceiros
Qual plano escolher para trabalho com API
- Prototipagem: Gratuito, com 10.000 caracteres v4 e 2 solicitações simultâneas.
- Um pequeno aplicativo ou automação: Starter ($6) para uma licença comercial e 75.000 caracteres v4.
- Produção com tráfego real: Pro ou Scale, principalmente pela simultaneidade (10 a 15 solicitações Multilingual v2) e maior qualidade de saída.
Se você está comparando APIs para voz em tempo real, o Inworld TTS é outra opção focada em desenvolvedores. Nosso guia de preços da ElevenLabs cobre o lado do aplicativo de cada plano.
Perguntas frequentes
Como obtenho uma chave de API da ElevenLabs?
Faça login, abra suas configurações de chaves de API (elevenlabs.io/app/settings/api-keys, também acessível através da seção de Desenvolvedores do painel), clique para criar uma chave, dê um nome a ela, defina quaisquer restrições e copie-a. Armazene-a como um segredo, por exemplo, como ELEVENLABS_API_KEY em um arquivo .env.
A API da ElevenLabs é gratuita?
Existe uma franquia gratuita: o plano Free inclui 10.000 caracteres de fala Eleven v4 (20.000 nos modelos Turbo e Flash) e cerca de 4,5 horas de transcrição Scribe v2. A saída do plano gratuito não pode ser usada comercialmente.
Quanto custa a API da ElevenLabs?
A conversão de texto em fala custa $0,08 por 1.000 caracteres no v4, v3 e Multilingual v2, e $0,04 no v4 Turbo, v3 Conversational e Flash/Turbo. A conversão de fala em texto custa $0,22 por hora de áudio para o Scribe v2 e $0,39 para o Scribe v2 Realtime.
Quais são os limites de taxa da API da ElevenLabs?
A ElevenLabs limita solicitações simultâneas em vez de solicitações por minuto. O Multilingual v2 permite 2 de uma vez no plano Free, 3 no Starter, 5 no Creator, 10 no Pro e 15 no Scale e Business; o Flash permite o dobro disso. Solicitações acima do limite são colocadas na fila.
Onde coloco a chave de API em uma solicitação?
Em um cabeçalho HTTP chamado xi-api-key. Os SDKs oficiais para Python (elevenlabs) e JavaScript (@elevenlabs/elevenlabs-js) a aceitam como api_key ou apiKey ao criar o cliente.
O que acontece se minha chave de API vazar?
A ElevenLabs faz parte do programa de secret scanning do GitHub, portanto, uma chave enviada para um repositório público é desativada automaticamente na maioria dos planos. Faça a rotação: crie uma nova chave, altere seu aplicativo e, em seguida, exclua a antiga.