Documentação da ElevenLabs

Add ElevenLabs to my project: run `npx -y @elevenlabs/cli@latest onboard init` and follow what it prints.

Como a ElevenLabs funciona?

A ElevenLabs oferece infraestrutura de voz com IA: conversão de texto em fala, conversão de fala em texto, clonagem de voz, agentes de voz e áudio generativo. Você pode usá-la de quatro maneiras, voltadas a públicos diferentes.

ElevenCreative é um aplicativo web sem código em que criadores, produtores e editores geram locuções, músicas, dublagens e projetos de estúdio diretamente no navegador.

ElevenAgents é a plataforma para criar e operar agentes de voz, com um construtor visual para usuários não técnicos e controle programático completo para desenvolvedores.

ElevenAPI disponibiliza todos os recursos como uma interface REST com SDKs oficiais para Python e TypeScript, para que desenvolvedores possam incorporar voz a seus próprios aplicativos e workflows.

Reception.ai é uma recepcionista telefônica com IA pronta para implantação para pequenas e médias empresas, que atende chamadas, agenda compromissos e gerencia operações diárias em um único painel.

Escolha seu caminho

ElevenCreative

Saiba como usar a plataforma ElevenCreative com guias passo a passo

ElevenAgents

Saiba como criar, lançar e escalar agentes com a ElevenLabs

ElevenAPI

Saiba como integrar a API da ElevenLabs com exemplos e tutoriais

Conceitos

Vozes são as personalidades de fala usadas na geração de áudio. Cada voz tem um ID exclusivo — por exemplo, JBFqnCBsd6RMkjVDRZzb — que você seleciona no painel ou inclui em solicitações à API. A ElevenLabs mantém uma biblioteca com mais de 10.000 vozes. Você também pode clonar uma voz a partir de uma gravação de áudio ou gerar uma com base em uma descrição de texto.

Modelos controlam a qualidade, a latência e a cobertura de idiomas do áudio gerado. eleven_v4 produz o resultado mais expressivo em mais de 90 idiomas. eleven_v4_turbo é voltado para uso em tempo real, com latência mediana de cerca de 100 ms. Cada recurso — conversão de fala em texto, música, efeitos sonoros — tem seu próprio modelo dedicado. Consulte Qual modelo devo usar? para escolher um.

Como funciona o preço?

Créditos são a unidade de consumo compartilhada entre todos os produtos. A conversão de texto em fala custa um crédito por caractere de texto de entrada. Outras operações são cobradas por segundo de áudio processado. Os créditos são renovados mensalmente, e os créditos não utilizados são acumulados por até dois meses. Consulte os preços para ver todos os detalhes.

Para usar a API sem uma assinatura mensal, o Pay As You Go permite que você faça um pagamento antecipado, que é descontado conforme você usa a ElevenLabs, depois que os créditos da assinatura se esgotam.

Criado para produção

Qual é a velocidade do Text to Speech da ElevenLabs?

O Eleven v4 Turbo e o Eleven Flash v2.5 retornam o primeiro áudio com latência mediana de ~100 ms. O Scribe v2 Realtime retorna transcrições confirmadas com latência mediana de ~150 ms. Esses números não incluem a latência da aplicação e da rede, então o tempo até que seus usuários ouçam o áudio é maior. Como a latência é medida explica o que os números abrangem, e Otimização de latência mostra como reduzir a latência de ponta a ponta.

Como a ElevenLabs lida com escala?

Seu plano define quantas solicitações são processadas ao mesmo tempo. Um limite de concorrência não é um teto para conversas simultâneas: em geral, um limite de 5 costuma suportar cerca de 100 transmissões de áudio simultâneas, dependendo das vozes usadas e do caso de uso. Os planos Enterprise têm limites mais altos. Consulte Concorrência e prioridade para ver os limites de cada plano e orientações sobre testes de carga.

Controles Enterprise

• Implantações privadas executam o ElevenAgents, o Text to Speech e o Speech to Text na sua própria conta de nuvem, para que textos, áudios e transcrições permaneçam na sua rede.
• Residência de dados armazena seus dados em ambientes isolados na UE, Índia ou Singapura, em vez da localização padrão nos EUA. É um recurso Enterprise.
• Espaços de trabalho centralizam faturamento, recursos compartilhados, acesso da equipe e gerenciamento de chaves de API. Os espaços de trabalho Enterprise adicionam SSO via SAML 2.0 ou OIDC e logs de auditoria de ações administrativas no esquema OCSF.

Gere seu primeiro áudio

Instale o SDK, defina sua chave de API como uma variável de ambiente e converta texto em um arquivo MP3 com uma única solicitação. Para que seu agente de programação faça essa configuração, consulte Configure com seu agente de programação.

pip install elevenlabs python-dotenv

ELEVENLABS_API_KEY=<your_api_key_here>

from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
import os
load_dotenv()
elevenlabs = ElevenLabs(
  api_key=os.getenv("ELEVENLABS_API_KEY"),
)
audio = elevenlabs.text_to_speech.convert(
    text="The first move is what sets everything in motion.",
    voice_id="JBFqnCBsd6RMkjVDRZzb",  # "George" - browse voices at elevenlabs.io/app/voice-library
    model_id="eleven_v4",
    output_format="mp3_44100_128",
)
with open("output.mp3", "wb") as f:
    for chunk in audio:
        f.write(chunk)

elevenlabs text-to-speech convert \
  --voice-id JBFqnCBsd6RMkjVDRZzb \
  --model-id eleven_v4 \
  --text "The first move is what sets everything in motion." \
  --output-format mp3_44100_128 \
  --output output.mp3

O guia de início rápido da ElevenAPI aborda a mesma solicitação com mais detalhes, incluindo a configuração da CLI e a reprodução de áudio pelos seus alto-falantes.

O que posso criar com o ElevenAgents?

O ElevenAgents combina reconhecimento de fala, um LLM à sua escolha, Text to Speech e gerenciamento de turnos em um único agente de voz que você configura no painel ou pelos SDKs.

• Suporte ao cliente: responda a perguntas usando sua própria documentação ao vincular uma base de conhecimento ao agente.
• Linhas telefônicas: conecte um número da Twilio com a integração nativa para atender chamadas recebidas e realizadas, ou conecte seu sistema telefônico atual por entroncamento SIP.
• Campanhas ativas: faça muitas chamadas ativas de uma só vez com chamadas em lote.
• Sites e apps: incorpore um agente que atende por voz e texto com o widget.

O guia de início rápido do ElevenAgents cria um primeiro agente de ponta a ponta.

Qual modelo devo usar?

Comece pelo seu caso de uso. Cada ID de modelo abaixo é o valor a ser passado como model_id nas solicitações de API.

Consulte Como escolher o modelo certo para mais casos de uso e a referência de modelos para especificações completas.

Explore por recurso