시작하기
ListenHub Skills를 설치하고 5분 안에 첫 콘텐츠를 생성해 보세요.
이 가이드는 설치, 설정, 그리고 첫 콘텐츠 생성까지 차례대로 안내합니다.
사전 준비
- Agent Skills를 지원하는 AI 코딩 도구 — Claude Code, Cursor, Windsurf, OpenCode 등
- ListenHub API 키 — 먼저 무료 계정을 만들고, API 키를 발급받으세요
- curl과 jq — 보통은 기본으로 설치되어 있으며, 없으면 AI가 알아서 설치합니다
설치
npx skills add marswaveai/skillsbunx add-skill marswaveai/skills설치가 끝나면 skill 파일이 프로젝트 디렉터리에 자동으로 추가됩니다.
업데이트 방법과 AI Agent 자동화 절차는 Skills 업데이트를 참고하세요.
API 키 설정
처음 사용할 때 AI가 API 키가 설정되지 않았음을 감지하고 설정 과정을 안내합니다:
- ListenHub API 키 설정 페이지를 엽니다(로그인 필요)
- 새 API 키를 만들거나 기존 키를 복사합니다(형식:
lh_sk_...) - AI가 요청하면 키를 붙여 넣습니다
키는 자동으로 저장됩니다. 이 작업은 한 번만 하면 됩니다.
환경 변수로 키를 직접 설정할 수도 있습니다:
export LISTENHUB_API_KEY="lh_sk_..."이 줄을 ~/.zshrc(macOS) 또는 ~/.bashrc(Linux)에 추가한 뒤 source ~/.zshrc를 실행하세요.
첫 생성
다음 프롬프트 중 하나를 실행해 모든 것이 제대로 동작하는지 확인해 보세요:
| 예시 | 실행되는 동작 |
|---|---|
Make a podcast about AI trends | 팟캐스트 에피소드를 생성합니다 |
Read this aloud: Hello world | 텍스트를 음성 오디오로 변환합니다 |
Generate an image: a cat in space | AI 이미지를 생성합니다 |
Transcribe this file: meeting.m4a | 오디오를 텍스트로 전사합니다(오프라인) |
보이스 선택, 콘텐츠 대본 작성, 생성은 AI가 알아서 처리합니다. 완료되면 듣고, 보고, 다운로드할 수 있는 링크를 받게 됩니다.
결과 받기
생성이 완료되면:
- 팟캐스트와 음성 — 기본적으로 AI가 대화 안에 링크를 표시합니다. 로컬에 저장하려면 설정할 때 출력 모드를
download또는both로 지정하거나 "download audio"라고 말하세요 - 해설 영상 — AI가 대화 안에 링크를 제공하며, 요청하면 다운로드할 수 있습니다
- 이미지 — 기본적으로 대화 안에 표시되며, 출력 모드가
download이면.listenhub/image-gen/에 저장됩니다 - 전사 결과 — listenhub.ai의 에피소드 상세에서 확인할 수 있습니다
프롬프트 예시
| 목적 | 프롬프트 |
|---|---|
| 중국어 팟캐스트, quick 모드 | Make a podcast about XXX, in Chinese |
| 영어 팟캐스트, deep 모드 | Make a podcast about XXX, in English, mode: deep |
| 해설 영상 | Make an explainer video about XXX |
| 텍스트 음성 변환 | Read this aloud: [your text] |
| 이미지 생성 | Generate an image: XXX, 16:9, 2K |
기본 동작
일부 파라미터를 지정하지 않으면 AI가 적절한 기본값을 사용합니다:
| 파라미터 | 기본값 |
|---|---|
| 언어 | 입력 내용에서 자동 감지 |
| 팟캐스트 모드 | quick + 1인(주제만 주어진 경우) |
| 보이스 | 감지된 언어에서 사용할 수 있는 첫 번째 보이스 |
| 음성 모드 | FlowSpeech direct(텍스트를 그대로 읽음) |
다음 단계
더 많은 예시와 그림으로 따라 하는 안내는 Way to AGI 워크숍 튜토리얼(Feishu)을 참고하세요.