ListenHubSkills

도움말과 FAQ

자주 묻는 질문, 문제 해결, 도움 받는 방법.

자주 묻는 질문

API 키

Q: "API Key not configured"가 표시됩니다

처음 사용할 때 AI가 설정 과정을 안내합니다. 그 단계를 건너뛰었다면 직접 설정하세요:

  1. ListenHub API 키 설정에 접속
  2. API 키를 생성하거나 복사(lh_sk_로 시작)
  3. 실행: export LISTENHUB_API_KEY="lh_sk_your_key_here"
  4. 설정이 유지되도록 ~/.zshrc 또는 ~/.bashrc에 해당 줄 추가

Q: 무료 플랜에서도 Skills를 쓸 수 있나요?

네. 모든 사용자가 API 키 설정 페이지에서 API 키를 발급받아 Skills를 사용할 수 있습니다.

생성

Q: 생성이 너무 오래 걸립니다

팟캐스트는 보통 23분, 해설 영상은 35분 걸립니다. 10분을 넘기면 서버가 혼잡한 것일 수 있습니다. 언제든 "다 됐어?"라고 물어 상태를 확인하거나 다시 요청하세요.

Q: 생성 품질을 어떻게 높이나요?

몇 가지 방향이 있습니다:

  • 주제를 구체적으로 잡으세요("AI 코딩"보다 "AI 코딩의 세 가지 핵심 패러다임 전환"이 더 잘 나옵니다)
  • 모드를 지정하세요: deep(더 길고 자세함) 또는 quick(간결함)
  • 요청에서 언어를 명시적으로 지정하세요
  • 오디오를 생성하기 전에 스크립트를 검토하려면 스크립트 우선 팟캐스트를 사용하세요

Q: 직접 쓴 스크립트로 팟캐스트를 만들 수 있나요?

네. 스크립트 우선 팟캐스트의 2단계 기능으로 직접 만든 스크립트 JSON을 넘겨 오디오를 바로 생성하세요. 또는 대사별로 보이스를 정확히 배정하고 싶다면 다중 보이스 대본을 사용하세요.

이미지

Q: 참조 이미지는 반드시 이미지 호스팅에 올려야 하나요?

네. 참조 이미지에는 공개적으로 접근 가능한 URL이 필요합니다. 로컬 파일 경로는 지원되지 않습니다. 추천 무료 호스팅: imgbb.com, sm.ms, postimages.org. 업로드한 뒤 직접 링크를 복사하세요(보통 .jpg 또는 .png로 끝납니다).

Q: 생성된 이미지는 어디에 저장되나요?

기본값은 ~/Downloads이며, 파일 이름은 listenhub-{date}-{time}-{id}.jpg 형식입니다.

보이스

Q: 사용 가능한 보이스 목록은 어떻게 보나요?

AI에게 직접 물어보세요 — 예를 들어 "영어 보이스는 어떤 게 있어?" 또는 "보이스 목록 보여 줘". AI가 보이스 조회 API를 호출해 전체 목록을 반환합니다.

Q: 직접 클로닝한 보이스를 쓸 수 있나요?

ListenHub 플랫폼에서 보이스 클로닝을 완료했다면, 클로닝된 보이스가 사용 가능한 보이스 목록에 표시되며 그대로 쓸 수 있습니다.


자주 발생하는 오류

Error: Invalid JSON format

TTS 다중 보이스 대본이나 직접 만든 팟캐스트 스크립트를 쓸 때는 JSON 구조가 유효한지 확인하세요:

{
  "scripts": [
    { "content": "Line content", "speakerId": "voice-id" }
  ]
}

curl: command not found 또는 jq: command not found

Skills는 curljq에 의존합니다. 대부분의 경우 AI가 자동으로 설치합니다. 설치되지 않으면 직접 설치하세요:

# macOS
brew install curl jq

# Ubuntu/Debian
sudo apt install curl jq

작업이 오랫동안 "processing" 상태에서 멈춤

가능한 원인: 서버 대기열 또는 네트워크 타임아웃. 다음을 시도해 보세요:

  1. 1~2분 기다렸다가 상태를 다시 확인
  2. 10분이 지나도 계속되면 생성 요청을 다시 전송

일반적인 문제 해결

예상치 못한 일이 생기면 먼저 설치 명령을 다시 실행하세요. 항상 최신 버전을 가져오므로 이미 수정이 포함되어 있을 수 있습니다:

npx skills add marswaveai/skills

무엇이든 AI에게 물어보세요

위 내용으로 해결되지 않으면 자연어로 물어보세요. AI는 ListenHub Skills가 할 수 있는 모든 것을 알고 있습니다:

"ListenHub로 뭘 할 수 있어?"

AI에게 ListenHub로 무엇을 할 수 있는지 묻기

지원 문의

추가 도움이 필요하면 support@marswave.ai로 연락하세요.

이 페이지의 내용