환경 변수 설정 (Linux/Mac)

export ELEVEN_API_KEY=“YOUR_API_KEY”

Windows PowerShell

client = ElevenLabs(api_key=“YOUR_API_KEY”)

계정 정보 및 잔여 크레딧 확인

무음 구간 제거 (클로닝 품질 향상)

PVC 생성 시 동의 오디오 파일 필요

동의 스크립트: “I [본인 이름] hereby authorize [제작사명] to

create and use a digital clone of my voice.”

with open(“consent_recording.wav”, “rb”) as consent,
open(“trimmed_source.wav”, “rb”) as source: voice = client.voices.add( name=“팟캐스트_호스트_김진수”, description=“팟캐스트 ‘테크 인사이트’ 메인 호스트”, files=[source], labels={“project”: “tech_insight_podcast”, “role”: “host”} )

def generate_podcast_segment(text, voice_id, preset_name): settings = PODCAST_PRESETS[preset_name]

audio = client.text_to_speech.convert(
    voice_id=voice_id,
    text=text,
    model_id="eleven_multilingual_v2",
    voice_settings={
        "stability": settings["stability"],
        "similarity_boost": settings["similarity_boost"],
        "style": settings["style"],
        "use_speaker_boost": settings["use_speaker_boost"]
    }
)
return audio</code></pre>

5단계: 에피소드별 일관성 워크플로우

매 에피소드마다 동일한 음질과 톤을 유지하는 자동화 스크립트입니다. import json from pathlib import Path from elevenlabs import ElevenLabs

client = ElevenLabs(api_key=“YOUR_API_KEY”)

def _load_config(self):
    if self.config_path.exists():
        return json.loads(self.config_path.read_text())
    return {"voices": {}, "episodes": []}

def save_config(self):
    self.config_path.write_text(
        json.dumps(self.config, indent=2, ensure_ascii=False)
    )

def register_voice(self, name, voice_id, preset):
    self.config["voices"][name] = {
        "voice_id": voice_id,
        "preset": preset
    }
    self.save_config()

def generate_episode(self, episode_num, segments):
    """segments: [{text, voice_name, preset_name, output_file}]"""
    episode_log = {"episode": episode_num, "segments": []}
    
    for seg in segments:
        voice_cfg = self.config["voices"][seg["voice_name"]]
        audio = generate_podcast_segment(
            text=seg["text"],
            voice_id=voice_cfg["voice_id"],
            preset_name=seg["preset_name"]
        )
        
        output = Path(f"ep{episode_num:03d}_{seg['output_file']}")
        output.write_bytes(audio)
        episode_log["segments"].append({
            "file": str(output),
            "voice": seg["voice_name"],
            "preset": seg["preset_name"]
        })
    
    self.config["episodes"].append(episode_log)
    self.save_config()
    return episode_log

result = manager.generate_episode(1, [ {“text”: “안녕하세요, 테크 인사이트 팟캐스트입니다.”, “voice_name”: “host”, “preset_name”: “narration”, “output_file”: “intro.wav”}, {“text”: “오늘의 스폰서는…”, “voice_name”: “host”, “preset_name”: “ad_read”, “output_file”: “ad.wav”} ])

Pro Tips: 파워 유저를 위한 고급 기법

• A/B 테스트 자동화: 동일 텍스트를 stability 0.5~0.7 범위에서 0.05 단위로 생성하여 최적값을 찾으세요. 리스너 피드백과 교차 검증하면 최적의 설정을 발견할 수 있습니다.- 다국어 팟캐스트: eleven_multilingual_v2 모델은 한국어 억양을 잘 보존합니다. 영어 혼용 시 similarity를 0.8 이상으로 설정하세요.- 배치 처리: 긴 스크립트는 문단 단위로 분할하여 생성 후 FFmpeg로 결합하면 API 타임아웃을 방지할 수 있습니다.- Voice ID 백업: 음성을 생성한 직후 client.voices.get(voice_id)로 설정값을 JSON 백업해 두세요.- 크레딧 관리: eleven_turbo_v2_5 모델은 크레딧 소모가 적어 초안 확인용으로 활용하고, 최종본에만 multilingual_v2를 사용하세요.

Troubleshooting: 자주 발생하는 오류 해결

Q1: Instant Voice Clone과 Professional Voice Clone의 차이는 무엇인가요?

Instant Voice Clone은 짧은 오디오 샘플(1분 이상)로 빠르게 클로닝할 수 있지만, Professional Voice Clone(PVC)은 더 긴 샘플과 동의 검증을 요구하는 대신 훨씬 높은 품질과 유사도를 제공합니다. 팟캐스트처럼 반복적으로 사용하는 경우 PVC를 강력히 권장합니다.

Q2: 소스 오디오에 배경 음악이 포함되어 있어도 되나요?

배경 음악은 클로닝 품질을 크게 저하시킵니다. 반드시 음성만 포함된 깨끗한 녹음을 사용하세요. 기존 팟캐스트 에피소드에서 추출할 경우, 인트로/아웃트로 음악 구간을 제거하고 순수 대화 부분만 사용해야 합니다. FFmpeg의 afftdn 필터로 잔여 노이즈를 제거할 수 있습니다.

Q3: 매주 발행하는 팟캐스트에서 음성 일관성을 어떻게 유지하나요?

본 가이드의 PodcastVoiceManager 클래스처럼 설정값을 JSON 파일로 관리하고, 에피소드 생성 시 항상 동일한 프리셋을 참조하세요. 또한 ElevenLabs 대시보드에서 Voice Settings를 저장해두면 API 호출 없이도 웹 인터페이스에서 동일한 설정으로 생성할 수 있습니다. 월 1회 정도 테스트 생성으로 품질 드리프트 여부를 확인하는 것도 좋은 습관입니다.