보이스 체인저 빠른 시작

보이스 체인저 API를 사용해 오디오 파일의 음성을 변환하는 방법을 알아보세요.

이 가이드에서는 보이스 체인저 API를 사용해 오디오 파일의 음성을 변환하는 방법을 알아봅니다.

ElevenLabs voice-changer skill을 사용하면 AI 코딩 어시스턴트에서 오디오 파일의 음성을 변환할 수 있습니다.

npx skills add elevenlabs/skills --skill voice-changer

보이스 체인저 API 사용하기

1

API 키 만들기

대시보드에서 API 키를 생성하세요. 이 키로 API에 안전하게 액세스할 수 있습니다.

키는 관리형 시크릿으로 저장하고, .env 파일을 통한 환경 변수 또는 앱 구성에서 직접 SDK에 전달하세요.

.env
ELEVENLABS_API_KEY=<your_api_key_here>
2

SDK 설치

환경 변수에서 API 키를 불러오기 위해 dotenv 라이브러리도 사용합니다.

pip install elevenlabs
pip install python-dotenv

스피커로 오디오를 재생하려면 MPV 및/또는 ffmpeg를 설치하라는 안내가 표시될 수 있습니다.

3

API 요청 보내기

사용하는 언어에 따라 example.py 또는 example.mts라는 새 파일을 만들고 다음 코드를 추가하세요.

# example.py
import os
from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
from elevenlabs.play import play
import requests
from io import BytesIO
load_dotenv()
elevenlabs = ElevenLabs(
api_key=os.getenv("ELEVENLABS_API_KEY"),
)
voice_id = "JBFqnCBsd6RMkjVDRZzb"
audio_url = (
"https://storage.googleapis.com/eleven-public-cdn/audio/marketing/nicole.mp3"
)
response = requests.get(audio_url)
audio_data = BytesIO(response.content)
audio_stream = elevenlabs.speech_to_speech.convert(
voice_id=voice_id,
audio=audio_data,
model_id="eleven_multilingual_sts_v2",
output_format="mp3_44100_128",
)
play(audio_stream)

그런 다음 실행하세요.

python example.py

변환된 음성이 스피커를 통해 재생됩니다.

다음 단계