탐색으로 건너뛰기
튜토리얼

음향 효과 빠른 시작

Sound Effects API를 사용해 음향 효과를 생성하는 방법을 알아보세요.

이 가이드에서는 Sound Effects API를 사용해 음향 효과를 생성하는 방법을 알아봅니다.

ElevenLabs 음향 효과 스킬을 사용해 AI 코딩 어시스턴트에서 음향 효과를 생성하세요.

npx skills add elevenlabs/skills --skill sound-effects

Sound Effects 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
load_dotenv()
elevenlabs = ElevenLabs(
  api_key=os.getenv("ELEVENLABS_API_KEY"),
)
audio = elevenlabs.text_to_sound_effects.convert(text="Cinematic Braam, Horror")
play(audio)

그런 다음 실행하세요.

python example.py

생성된 음향 효과가 스피커를 통해 재생되는 것을 들을 수 있습니다.

다음 단계

음향 효과 개요

음향 효과 생성, 지원 형식 및 사용 사례 알아보기

텍스트 음성 변환

텍스트 음성 변환 API로 텍스트에서 음성 오디오 생성하기

API 레퍼런스

모든 Sound Effects 파라미터와 응답 형식 살펴보기