AAperture
Back/ai tools

ListenHub CLI

2 min read
361 words

ListenHub CLI

AI 音频内容生成 CLI 工具，支持音乐生成、播客、TTS、PPT 幻灯片。

基本信息

CLI 地址: https://github.com/marswaveai/listenhub-cli SDK 地址: https://github.com/marswaveai/listenhub-sdk 类型: CLI工具 / SDK 语言: TypeScript (SDK) 协议: MIT 用途: AI 音乐、播客、TTS、幻灯片生成

功能特性

音乐生成

给一段文字描述，直接出一首曲子：

listenhub music generate \
  --prompt "动感电子舞曲" \
  --style "EDM" \
  --title "夜间飞驰"

纯音乐（无人声）：

listenhub music generate --prompt "宁静的钢琴旋律" --instrumental

翻唱功能

支持本地音频文件（mp3、wav、flac、m4a、ogg、aac，最大 20MB）：

listenhub music cover --audio ./original.mp3 --title "我的混音"

也支持 URL：

listenhub music cover --audio https://example.com/song.mp3

PPT 幻灯片生成

给个主题就能生成一套带配音的幻灯片：

listenhub slides create --query "TypeScript 入门指南"

播客生成

支持 quick、deep、debate 三种模式，可丢参考链接：

listenhub podcast create \
  --query "2026年AI趋势" \
  --mode deep \
  --source-url https://example.com/article \
  --lang zh

TTS 语音合成

listenhub tts create --text "你好世界" --lang zh

图片生成

支持传本地参考图，最多可传多张：

listenhub image create \
  --prompt "水彩风格的小龙" \
  --reference ./sketch.jpg \
  --reference ./palette.png \
  --aspect-ratio 16:9 --size 4K

脚本集成

所有创作命令都支持 --json 输出和 --no-wait 异步模式：

ID=$(listenhub music generate --prompt "测试" --no-wait --json | jq -r '.taskId')
listenhub music get "$ID" --json

SDK 集成

底层 SDK 也一起开源，包名 @marswave/listenhub-sdk：

npm i @marswave/listenhub-sdk

使用示例：

const client = new ListenHubClient({
  accessToken: 'your-token',
  maxRetries: 2,
});

// 生成音乐
const task = await client.createMusicGenerate({
  prompt: 'Upbeat lo-fi hip hop beat with jazzy piano chords',
  style: 'lo-fi',
  title: 'Late Night Study',
});

// 创建播客
const { episodeId } = await client.createPodcast({ ... });

// 生成图片
await client.createAIImage({ ... });

安装和更新

要求 Node.js >= 20：

# 安装
npm install -g @marswave/listenhub-cli

# 登录
listenhub auth login

# 更新
npm install -g @marswave/listenhub-cli@latest

Token 存储在 ~/.config/listenhub/credentials.json，过期自动刷新。

AI Agent应用场景

内容创作自动化

  • Agent 自动生成播客内容
  • 批量生成 TTS 语音
  • 自动创建带配音的演示文稿

多媒体工作流

  • 音乐生成 + 图片生成 → 完整视频内容
  • 播客生成 + 自动发布 → 内容分发管道
  • 幻灯片生成 + TTS → 自动化教学材料

创意辅助

  • 快速原型音乐创意
  • 自动生成内容变体
  • 批量处理音频内容

注意事项

  • 需要 OAuth 登录授权
  • 注意 API 调用限制和配额
  • 大文件上传需要时间
  • 异步任务需要轮询获取结果

相关资源

评估状态

  • 已安装测试
  • 已集成到工作流
  • 已用于实际项目

来源: ListenHub CLI 发布并开源，AI 音乐首次支持 作者: AGENT橘 发布时间: 2026-04-09

Linked from