Ir para a navegação

Guia rápido da ElevenAPI

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

Ao final deste guia, você terá configurado a ElevenLabs no seu projeto e poderá fazer sua primeira solicitação de Text to Speech. Há duas formas de fazer isso: deixar seu agente de programação realizar a configuração ou fazer tudo manualmente.

Para guias sobre outros recursos — streaming, clonagem de voz, Speech to Text — consulte a seção Tutoriais.

Configure com seu agente de programação

Você não precisa ter uma conta nem uma chave de API antes de começar. Cole isto no seu agente de programação:

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

A CLI da ElevenLabs cuida do resto e informa cada etapa ao seu agente. Seu navegador abre uma vez para que você possa entrar ou criar uma conta e clicar em Autorizar. A chave é salva no arquivo de ambiente do seu projeto (.env.local ou .env em um projeto Python) e fica fora do git; ela nunca é exibida no chat. Em seguida, o agente pergunta o que você gostaria de criar, instala o SDK, adiciona o código ao seu app e pergunta se deseja enviar uma solicitação de teste.

Se o seu agente for executado em algum lugar que seu navegador não possa acessar, como uma máquina remota via SSH ou um ambiente isolado na nuvem, a CLI pede que você crie uma chave e a cole no arquivo de ambiente, depois continua. O comando precisa do Node.js para npx. Sem ele, instale a CLI da ElevenLabs com Homebrew (macOS e Linux) ou Scoop (Windows), ou atualize-a caso já a tenha (brew upgrade elevenlabs, scoop update elevenlabs) e peça ao seu agente para executar elevenlabs onboard init.

Configure manualmente

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 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 seguinte código:

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 alto-falantes.

Próximos passos