로컬 ElevenLabs API 키

3분 읽기

본인의 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으로는 전송되지 않습니다.