ElevenLabs 명령

All 모든 명령 복사 < PDF 생성

종합 ElevenLabs AI 음성 합성 명령 및 워크플로우 텍스트-to-speech 및 음성 생성.

API 인증

Command	Description
curl -H "xi-api-key: <api-key>" <endpoint>	API authentication
export ELEVEN_API_KEY=<key>	Set environment variable
elevenlabs auth login	Login to account
elevenlabs auth logout	Logout from account
elevenlabs auth status	Check authentication status

텍스트로 변환 API

Endpoint	Description
POST /v1/text-to-speech/{voice_id}	Generate speech
POST /v1/text-to-speech/{voice_id}/stream	Stream speech
GET /v1/voices	List available voices
GET /v1/voices/{voice_id}	Get voice details
POST /v1/voices/add	Add custom voice

음성 관리

Command	Description
GET /v1/voices	List all voices
GET /v1/voices/{voice_id}	Get voice information
DELETE /v1/voices/{voice_id}	Delete custom voice
POST /v1/voices/{voice_id}/edit	Edit voice settings
GET /v1/voices/settings	Get voice settings

관련 기사

Command	Description
curl -X POST "https://api.elevenlabs.io/v1/text-to-speech/21m00Tcm4TlvDq8ikWAM" -H "xi-api-key: <key>" -H "Content-Type: application/json" -d '{"text": "Hello world"}'	Basic speech generation
curl -X POST "https://api.elevenlabs.io/v1/text-to-speech/21m00Tcm4TlvDq8ikWAM/stream" -H "xi-api-key: <key>"	Streaming speech

파이썬 SDK

Command	Description
pip install elevenlabs	Install Python SDK
from elevenlabs import generate, play	Import SDK
generate(text="Hello", voice="Bella")	Generate speech
play(audio)	Play generated audio
save(audio, "output.mp3")	Save audio file

음성 Cloning

Command	Description
POST /v1/voices/add	Clone voice from samples
POST /v1/voices/{voice_id}/samples	Add voice samples
DELETE /v1/voices/{voice_id}/samples/{sample_id}	Delete voice sample
GET /v1/voices/{voice_id}/samples	List voice samples

음성 설정

Parameter	Description
stability	Voice consistency (0.0-1.0)
similarity_boost	Voice similarity (0.0-1.0)
style	Speaking style (0.0-1.0)
use_speaker_boost	Enhance speaker similarity

오디오 형식

Format	Description
mp3_44100_128	MP3 44.1kHz 128kbps
mp3_22050_32	MP3 22.05kHz 32kbps
pcm_16000	PCM 16kHz
pcm_22050	PCM 22.05kHz
pcm_24000	PCM 24kHz
pcm_44100	PCM 44.1kHz

사전 제작된 목소리

Voice ID	Name	Description
21m00Tcm4TlvDq8ikWAM	Rachel	American female
AZnzlk1XvdvUeBnXmlld	Domi	American female
EXAVITQu4vr4xnSDxMaL	Bella	American female
ErXwobaYiN019PkySvjV	Antoni	American male
MF3mGyEYCl7XYWbV9V6O	Elli	American female
TxGEqnHWrfWFTfGW9XjX	Josh	American male
VR6AewLTigWG4xSOukaG	Arnold	American male
pNInz6obpgDQGcFmaJgB	Adam	American male

Node.js SDK 사용

Command	Description
npm install elevenlabs	Install Node.js SDK
const { ElevenLabsAPI } = require('elevenlabs')	Import SDK
const client = new ElevenLabsAPI({ apiKey: 'key' })	Initialize client
client.textToSpeech.generate()	Generate speech

스트리밍 오디오

Command	Description
POST /v1/text-to-speech/{voice_id}/stream	Stream audio
curl -X POST -H "xi-api-key: <key>" --data-raw '{"text":"Hello"}' --output audio.mp3	Stream to file

음성 랩 기능

Feature	Description
Voice Design	Create synthetic voices
Voice Cloning	Clone existing voices
Professional Cloning	High-quality voice cloning
Voice Library	Browse voice collection

API 비율 한계

Plan	Characters/Month	Concurrent Requests
Free	10,000	2
Starter	30,000	3
Creator	100,000	5
Pro	500,000	10
Scale	2,000,000	25

오류 처리

Error Code	Description
400	Bad Request
401	Unauthorized
403	Forbidden
404	Not Found
422	Unprocessable Entity
429	Too Many Requests
500	Internal Server Error

고급 매개 변수

Parameter	Description
model_id	TTS model to use
voice_settings	Voice configuration
pronunciation_dictionary_locators	Custom pronunciations
seed	Reproducible generation

Webhook 구성

Command	Description
POST /v1/webhooks	Create webhook
GET /v1/webhooks	List webhooks
DELETE /v1/webhooks/{webhook_id}	Delete webhook
PUT /v1/webhooks/{webhook_id}	Update webhook

프로젝트 및 Dubbing

Command	Description
POST /v1/projects	Create project
GET /v1/projects	List projects
POST /v1/dubbing	Create dubbing project
GET /v1/dubbing/{dubbing_id}	Get dubbing status

사용법 Analytics

Command	Description
GET /v1/user/subscription	Get subscription info
GET /v1/user	Get user information
GET /v1/usage/character-stats	Get usage statistics

제품정보 제품 정보

Command	Description
elevenlabs --help	Show help
elevenlabs tts --text "Hello" --voice Rachel	Generate speech
elevenlabs voices list	List voices
elevenlabs voices clone --name "MyVoice"	Clone voice

Python 예제

Code	Description
audio = generate(text="Hello", voice="Bella", model="eleven_monolingual_v1")	Basic generation
play(audio)	Play audio
save(audio, "hello.mp3")	Save to file

JavaScript 예제

Code	Description
const audio = await elevenlabs.generate({ text: "Hello", voice: "Rachel" })	Generate audio
fs.writeFileSync("audio.mp3", audio)	Save to file

음성 Cloning 과정

Step	Description
1. Upload samples	Provide voice samples
2. Train model	AI learns voice patterns
3. Test generation	Verify voice quality
4. Fine-tune settings	Adjust parameters
5. Deploy voice	Use in production

최고의 연습

Practice	Description
Clear audio samples	High-quality recordings
Diverse samples	Various emotions/styles
Consistent speaker	Same person throughout
Proper length	1-5 minutes total
Good microphone	Professional recording

통합 예제

Platform	Integration
Discord Bot	Voice message generation
Podcast	Automated narration
E-learning	Course voice-overs
Gaming	Character voices
Accessibility	Text-to-speech for visually impaired

문제 해결

Issue	Solution
Poor voice quality	Improve sample quality
Rate limit exceeded	Upgrade plan or wait
Authentication failed	Check API key
Voice not found	Verify voice ID
Audio distortion	Adjust voice settings

환경 변수

Variable	Description
ELEVEN_API_KEY	API authentication key
ELEVEN_API_URL	API base URL
ELEVEN_TIMEOUT	Request timeout

구성 파일

File	Description
.elevenlabs.json	Configuration file
voices.json	Voice definitions
settings.json	Default settings

모니터링 및 분석

Metric	Description
Characters used	Monthly usage
API calls	Request count
Voice generations	Audio created
Error rate	Failed requests