Começar

Início rápido da ElevenAPI

Aprenda a fazer sua primeira solicitação à API da ElevenLabs.

Ao final deste guia, você terá um script funcional que envia uma string de texto para a API da ElevenLabs e reproduz o áudio retornado pelos seus alto-falantes. Você aprenderá a se autenticar com uma chave de API, instalar o SDK e fazer sua primeira solicitação de conversão de texto em voz.

Para guias sobre outros recursos — streaming, clonagem de voz e conversão de voz em texto — consulte a seção de Tutoriais.

Use a skill de conversão de texto em voz da ElevenLabs para gerar fala com seu assistente de programação com IA:

npx skills add elevenlabs/skills --skill text-to-speech

Usando a API de Text to Speech

1

Crie uma chave de API

Crie uma chave de API no painel aqui, que você usará para acessar a API com segurança.

Armazene a chave como um segredo gerenciado e passe-a aos SDKs como uma variável de ambiente por meio de um arquivo .env ou diretamente na configuração do seu app, conforme sua preferência.

.env
ELEVENLABS_API_KEY=<your_api_key_here>
2

Instale o SDK

Também usaremos a biblioteca dotenv para carregar nossa chave de API de uma variável de ambiente.

pip install elevenlabs
pip install python-dotenv

Para reproduzir o áudio pelos seus alto-falantes, talvez seja solicitado que você instale o MPV e/ou o ffmpeg.

3

Faça sua primeira solicitação

Crie um novo arquivo chamado example.py ou example.mts, dependendo da linguagem escolhida, e adicione o código a seguir:

from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
from elevenlabs.play import play
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",
)
play(audio)

Em seguida, execute-o:

python example.py

Você deverá ouvir o áudio pelos seus alto-falantes.

Próximos passos

Transmita áudio

Reduza a latência transmitindo o áudio à medida que ele é gerado, em vez de esperar pelo arquivo completo

Explore vozes

Explore mais de 10.000 vozes e substitua o ID de voz do exemplo por um adequado ao seu caso de uso

Clone uma voz

Crie uma voz personalizada a partir de uma gravação de áudio curta