Tutoriais

Início rápido de alinhamento forçado

Aprenda a usar a API de alinhamento forçado para alinhar texto ao áudio.

Este guia mostrará como usar a API de alinhamento forçado para alinhar texto ao áudio.

Usando a API de alinhamento forçado

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
3

Faça a solicitação à API

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

# example.py
import os
from io import BytesIO
from elevenlabs.client import ElevenLabs
import requests
from dotenv import load_dotenv
load_dotenv()
elevenlabs = ElevenLabs(
    api_key=os.getenv("ELEVENLABS_API_KEY"),
)
audio_url = (
    "https://storage.googleapis.com/eleven-public-cdn/audio/marketing/nicole.mp3"
)
response = requests.get(audio_url)
audio_data = BytesIO(response.content)
# Perform the text-to-speech conversion
transcription = elevenlabs.forced_alignment.create(
    file=audio_data,
    text="With a soft and whispery American accent, I'm the ideal choice for creating ASMR content, meditative guides, or adding an intimate feel to your narrative projects."
)
print(transcription)

Em seguida, execute-o:

python example.py

Você verá no console a transcrição do arquivo de áudio com timestamps exatos.

Próximas etapas

Speech to Text

Transcreva áudio em texto sem precisar de uma transcrição existente

Text to Speech

Gere áudio a partir de texto para usar com alinhamento forçado

Referência da API

Explore todos os parâmetros e formatos de resposta do alinhamento forçado