快速开始
安装 ListenHub Skills，5 分钟内生成你的第一份内容。
本指南将带你完成安装、配置，并生成你的第一份内容。
前置条件
- 支持 Agent Skills 的 AI 编码工具 — Claude Code、Cursor、Windsurf、OpenCode 等
- ListenHub API Key — 先 注册免费账号，然后 获取 API Key
- curl 和 jq — 通常已预装；如未安装，AI 会自动帮你安装
安装
npx skills add marswaveai/skillsbunx add-skill marswaveai/skills安装完成后，Skill 文件会自动添加到当前项目目录中。
更新
详见 更新 Skills — 包含更新方法和 AI Agent 自动化操作说明。
配置 API Key
首次使用时，AI 会自动检测到未配置 API Key 并引导你完成设置：
- 打开 ListenHub API Key 设置页面（需要先登录）
- 创建新的 API Key 或复制已有的（格式为
lh_sk_...） - 在 AI 提示时粘贴 Key 并回车
Key 会自动保存，只需配置一次。
也可以手动设置环境变量：
export LISTENHUB_API_KEY="lh_sk_..."将此行添加到 ~/.zshrc（macOS）或 ~/.bashrc（Linux），然后运行 source ~/.zshrc。
第一次生成
试试以下提示词，验证一切正常：
| 示例 | 会发生什么 |
|---|---|
做个关于 AI 趋势的播客 | 生成一期播客节目 |
朗读这段文字：你好世界 | 将文字转为语音 |
生成图片：太空中的猫 | 创建一张 AI 图片 |
转录这个文件 meeting.m4a | 将音频转为文字（离线运行） |
AI 会自动处理选声、写稿和生成。完成后你会收到一个链接，用于收听、观看或下载。
获取结果
生成完成后：
- 播客和语音 — 默认以链接形式展示在对话中。如需保存到本地，可在配置时将输出方式设为
download或both - 解说视频 — 默认以链接形式展示；可按需下载
- 图片 — 默认内联展示；输出方式为
download时保存到.listenhub/image-gen/ - 文稿 — 在 listenhub.ai 的单集详情页中查看
示例提示词
| 目标 | 提示词 |
|---|---|
| 中文播客，快速模式 | 做个播客，主题是 XXX，用中文 |
| 英文播客，深度模式 | 做个播客，主题是 XXX，要英文的，mode: deep |
| 解说视频 | 做个解说视频，内容是 XXX |
| 文字转语音 | 朗读这段文字：[你的文本] |
| 图片生成 | 生成图片：XXX，16:9，2K |
默认行为
未指定某些参数时，AI 会使用合理的默认值：
| 参数 | 默认值 |
|---|---|
| 语言 | 根据输入内容自动判断 |
| 播客模式 | 快速 + 单人（仅提供主题时） |
| 音色 | 自动选择对应语言的首个可用音色 |
| 语音模式 | FlowSpeech direct（直接朗读，不修改原文） |
下一步
更多示例和图文教程参见 Way to AGI 社区图文教程。