도움말과 FAQ
자주 묻는 질문, 문제 해결, 도움 받는 방법.
자주 묻는 질문
API 키
Q: "API Key not configured"가 표시됩니다
처음 사용할 때 AI가 설정 과정을 안내합니다. 그 단계를 건너뛰었다면 직접 설정하세요:
- ListenHub API 키 설정에 접속
- API 키를 생성하거나 복사(
lh_sk_로 시작) - 실행:
export LISTENHUB_API_KEY="lh_sk_your_key_here" - 설정이 유지되도록
~/.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는 curl과 jq에 의존합니다. 대부분의 경우 AI가 자동으로 설치합니다. 설치되지 않으면 직접 설치하세요:
# macOS
brew install curl jq
# Ubuntu/Debian
sudo apt install curl jq작업이 오랫동안 "processing" 상태에서 멈춤
가능한 원인: 서버 대기열 또는 네트워크 타임아웃. 다음을 시도해 보세요:
- 1~2분 기다렸다가 상태를 다시 확인
- 10분이 지나도 계속되면 생성 요청을 다시 전송
일반적인 문제 해결
예상치 못한 일이 생기면 먼저 설치 명령을 다시 실행하세요. 항상 최신 버전을 가져오므로 이미 수정이 포함되어 있을 수 있습니다:
npx skills add marswaveai/skills무엇이든 AI에게 물어보세요
위 내용으로 해결되지 않으면 자연어로 물어보세요. AI는 ListenHub Skills가 할 수 있는 모든 것을 알고 있습니다:
"ListenHub로 뭘 할 수 있어?"

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