생성 버튼을 클릭했는데 오류가 발생했거나, 로딩 표시가 멈추면서 오디오가 만들어지지 않았나요? 이 페이지에서는 가장 흔한 원인과 각각의 해결 방법을 안내합니다. 위에서부터 순서대로 확인해 보세요.
빠른 체크리스트
먼저 아래 항목을 확인하세요. 대부분의 문제는 다음 네 가지 중 하나입니다.
- 크레딧 소진
- 유효하지 않거나 누락된 음성
- 선택한 모델에서 허용하는 텍스트 길이 초과
- 사이트가 TTSWP에 연결되지 않음
이 각각의 경우 오류 팝업에 구체적인 메시지가 표시됩니다. 결론을 내리기 전에 정확한 문구를 먼저 읽어 보세요.
원인 1: 크레딧 소진
오류 메시지: "크레딧이 부족합니다" 또는 "크레딧을 모두 사용했습니다"
발생 이유: TTSWP 월간 크레딧을 모두 소진했고, 추가 크레딧 잔액도 없으며, ElevenLabs BYOK 키도 연결되어 있지 않은 상태입니다.
해결 방법:
- 월간 크레딧 초기화를 기다리세요 (유료 플랜 이용 시). 텍스트 음성 변환 → 내 플랜 및 크레딧에서 초기화 날짜를 확인할 수 있습니다.
- 추가 크레딧 팩 구매.
- 보너스 크레딧을 위해 ElevenLabs API 키 연결.
- 플랜 업그레이드.
원인 2: 유효하지 않거나 누락된 음성
오류 메시지: "선택한 음성이 ElevenLabs 계정에서 더 이상 사용할 수 없습니다. 다른 음성을 선택해 주세요."
발생 이유: 기본값으로 설정했던 음성이 ElevenLabs 계정에서 삭제된 경우입니다. 복제된 음성이 삭제되거나 음성 ID가 잘못 저장된 경우 자주 발생합니다.
해결 방법:
- 텍스트 음성 변환 → 음성으로 이동하세요.
- 상단 표시줄에서 음성 새로고침을 클릭하세요.
- 목록에서 다른 음성을 선택하세요.
- 선택을 클릭하세요.
- 게시물 오디오를 다시 생성하세요.
원인 3: 모델에서 허용하는 텍스트 길이 초과
오류 메시지: "이 텍스트는 해당 모델에서 ElevenLabs가 허용하는 길이를 초과합니다. 텍스트를 줄이거나 다른 모델을 선택해 주세요."
발생 이유: ElevenLabs의 각 모델에는 요청당 문자 제한이 있습니다. Flash와 Turbo v2.5는 40,000자를 허용하지만, Multilingual v2는 10,000자, Eleven v3는 3,000자만 허용합니다. 게시물이 선택한 모델의 지원 범위를 초과했습니다.
해결 방법:
- 음성 페이지에서 더 높은 제한을 가진 모델로 전환하세요.
- 여러 개의 쇼트코드를 사용해 게시물을 더 짧은 섹션으로 나누세요.
no-audio클래스 또는 CSS 선택자를 사용해 일부 콘텐츠를 제외하세요.
음성 선택에서 모델별 제한 표를 확인하세요.
원인 4: 사이트가 연결되지 않음
증상: 개요 페이지에 크레딧 대신 보라색 연결 카드가 표시됩니다.
해결 방법: 먼저 사이트를 연결하세요. 연결 없이는 오디오 생성이 항상 실패합니다.
덜 흔한 원인
ElevenLabs BYOK 키가 유효하지 않음
오류: "TTS 합성 실패: 잘못된 API 키"
해결 방법: 자체 ElevenLabs 키 연결을 참조하여 키를 업데이트하세요.
네트워크 시간 초과
오류: "TTS 합성 실패: 작업 시간이 초과되었습니다"
발생 이유: 텍스트가 매우 길거나 ElevenLabs까지의 네트워크 경로가 느린 경우입니다.
해결 방법:
- 다시 시도해 보세요. 일시적인 시간 초과는 대부분 다음 시도에서 해결됩니다.
- 반복적으로 발생한다면 더 빠른 모델(Flash v2.5)과 더 짧은 텍스트를 사용해 보세요.
구독 결제 문제
오류: "구독에 실패하거나 미완료된 결제가 있습니다."
이유: ElevenLabs 구독에 미납된 청구서가 있는 경우입니다. 유료 ElevenLabs 계정으로 BYOK를 사용하는 경우에만 해당됩니다.
해결 방법: elevenlabs.io에 로그인하여 청구서를 결제하세요.
음성과 모델 언어 불일치
오류: "모델 X는 언어 코드 Y를 지원하지 않습니다"
이유: 모든 모델이 모든 언어를 지원하는 것은 아닙니다. WordPress 언어 코드를 정규화한 버전 3.1.7 이후로는 덜 흔한 문제입니다.
해결 방법: 음성 페이지에서 다른 언어를 선택하거나, 대부분의 주요 언어를 지원하는 Flash v2.5 모델로 변경하세요.
오류 메시지 확인 위치
게시물 목록에서 생성이 실패하면 TTS 열에 작은 오류 아이콘이 표시됩니다. 마우스를 올리면 메시지를 확인할 수 있습니다. 내 통계 → 최근 활동에서도 최근 시도 기록을 확인할 수 있습니다.
오류 메시지를 이해하기 어렵다면, 메시지를 복사하여 이 페이지 또는 지원에서 확인하세요.