로컬 ElevenLabs API 키

3 min read

본인의 ElevenLabs 키를 연결하는 표준 방법은 app.ttswp.com/settings를 통하는 것입니다. 대부분의 사용자는 이 방법을 사용하면 됩니다. 키를 WordPress에 직접 붙여넣고 싶다면, 플러그인이 로컬 키를 고급 대체 방법으로 지원합니다.

app.ttswp.com BYOK와 로컬 키 비교

app.ttswp.com BYOK 사용 (권장)

  • 퀵 통계에서 키별 한도 및 초기화 날짜를 확인하고 싶을 때
  • TTSWP가 키 교체 및 오류 감지를 처리하길 원할 때
  • Pro 또는 Agency 플랜을 사용하며 일반 결제 흐름의 혜택을 받을 때

로컬 키 사용

  • app.ttswp.com에 연결할 수 없을 때 (에어갭, 방화벽 제한)
  • 개발 환경에서 TTSWP를 테스트할 때
  • SaaS 연결을 완전히 우회해야 할 때

로컬 키 추가 방법

  1. 텍스트 음성 변환 → 고급으로 이동합니다.
  2. 로컬 ElevenLabs API 키를 찾습니다.
  3. 키를 붙여넣습니다 (sk_로 시작).
  4. 저장합니다.

플러그인은 ElevenLabs에 테스트 호출을 하여 키를 검증합니다. 키가 거부되면 빨간색 오류 메시지가 표시됩니다.

로컬 키 작동 방식

로컬 키가 설정되면:

  • 모든 오디오 생성이 WordPress에서 ElevenLabs로 직접 전달됩니다 (app.ttswp.com 우회)
  • TTSWP 크레딧이 사용되지 않습니다
  • UI에 키별 한도가 표시되지 않습니다 (가져오지 않음)
  • 퀵 통계는 키를 기반으로 ElevenLabs 연결 상태를 계속 표시합니다

장단점

사용할 수 없는 기능

  • 클라우드 오디오 저장 - 오디오가 WordPress 서버에만 저장됩니다
  • Agency 플랜의 크레딧 할당
  • app.ttswp.com의 사이트별 사용 로그
  • 자동 키 재검증 및 오류 보고

유지되는 기능

  • 모든 플레이어 기능
  • 음성 선택 및 모델 선택
  • 단축코드, 단어 교체, SSML
  • 통계 추적 (로컬)

로컬 키 제거

마스킹된 키 필드 옆의 제거를 클릭합니다. 플러그인이 정상 흐름으로 돌아갑니다 (연결된 경우 TTSWP 크레딧 또는 app.ttswp.com의 BYOK 사용).

암호화

로컬 키는 WordPress의 내장 암호화 유틸리티를 사용하여 WordPress 데이터베이스에 암호화되어 저장됩니다. app.ttswp.com으로는 전송되지 않습니다.

관련 페이지