탐색으로 건너뛰기
시작하기

ElevenAPI 빠른 시작

첫 ElevenLabs API 요청을 만드는 방법을 알아보세요.

이 가이드를 마치면 프로젝트에 ElevenLabs를 설정하고 첫 텍스트 음성 변환 요청을 보낼 수 있습니다. 설정 방법은 두 가지입니다. 코딩 에이전트가 설정하도록 하거나, 직접 설정할 수 있습니다.

스트리밍, 음성 복제, 음성 텍스트 변환 등 다른 기능에 관한 가이드는 튜토리얼 섹션을 참고하세요.

코딩 에이전트로 설정하기

시작하기 전에 계정이나 API 키가 필요하지 않습니다. 다음 내용을 코딩 에이전트에 붙여 넣으세요.

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

이후에는 ElevenLabs CLI가 진행하며, 에이전트에 각 단계를 안내합니다. 브라우저가 한 번 열리면 로그인하거나 계정을 만든 뒤 Authorize를 클릭하세요. 키는 프로젝트의 env 파일(Python 프로젝트는 .env.local 또는 .env)에 저장되고 git에는 포함되지 않으며, 채팅에 표시되지 않습니다. এরপর 에이전트가 만들고 싶은 것을 묻고, SDK를 설치하고, 앱에 코드를 추가한 뒤 테스트 요청을 보낼지 확인합니다.

에이전트가 SSH를 통한 원격 머신이나 클라우드 샌드박스처럼 브라우저에서 접근할 수 없는 곳에서 실행되는 경우, CLI가 직접 키를 생성해 env 파일에 붙여 넣도록 요청한 후 계속 진행합니다. 이 명령에는 npx를 위한 Node.js가 필요합니다. Node.js가 없다면 Homebrew(macOS 및 Linux) 또는 Scoop(Windows)으로 ElevenLabs CLI를 설치하거나, 이미 설치되어 있다면 업데이트한 뒤(brew upgrade elevenlabs, scoop update elevenlabs) 에이전트에게 대신 elevenlabs onboard init을 실행하도록 요청하세요.

직접 설정하기

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

첫 요청 보내기

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

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)

그런 다음 실행하세요.

python example.py

스피커로 오디오가 재생됩니다.

다음 단계

오디오 스트리밍

완성된 파일을 기다리는 대신 생성되는 즉시 오디오를 스트리밍하여 지연 시간을 줄이세요

음성 찾아보기

10,000개 이상의 음성을 둘러보고 예시 음성 ID를 사용 사례에 맞는 것으로 바꾸세요

음성 복제

짧은 오디오 녹음으로 맞춤 음성을 만드세요