OAuth 命令

listenhub OAuth 命令的完整参考——auth、podcast、tts、explainer、slides、music、image、video、speakers、lyrics 与 creation。

本页文档化 OAuth 命令集：以你登录的用户账户身份运行的 listenhub <domain> ... 命令。它们需要浏览器登录（listenhub auth login），并从 ~/.config/listenhub/credentials.json 读取令牌。用于脚本和 CI 的 API 密钥命令集，请参阅 OpenAPI 命令。

通用约定

下列行为适用于本页所有命令。

全局标志。 每个命令都接受 --json / -j（机器可读输出到 stdout，错误输出到 stderr）和 --help / -h。创建类命令还接受 --no-wait（立即返回 ID，不轮询）和 --timeout <seconds>（轮询等待上限，默认值因命令而异）。
轮询。 创建类命令先提交任务，然后每 10 秒轮询一次状态，直到任务进入终态。超时后命令以退出码 3 退出；任务仍在服务端继续运行，之后可凭 ID 获取结果。
语言自动检测。 当命令带有 --lang 而你省略它时，CLI 会根据输入文本推断语言：假名 → ja，其他 CJK 字符 → zh，否则 en。
说话人解析。 --speaker <name> 会通过列出当前检测语言的说话人来解析为 inner ID；--speaker-id <id> 则直接透传。两者都不提供时，CLI 会为检测到的语言挑选默认音色。
文件与 URL 自动识别。 接受 <path-or-url> 的标志会自动识别输入：http(s) URL 原样透传，本地路径则经过校验（扩展名与大小）并先上传到云存储再调用 API。支持的上传——音频：.mp3、.wav、.flac、.m4a、.ogg、.aac（最大 20 MB）；图片：.jpg、.jpeg、.png、.webp、.gif（最大 10 MB）；视频：.mp4、.mov（最大 50 MB）。部分 Mureka 音乐子命令仅接受本地文件（不支持 URL）并有各自的限制，详见对应命令说明。
退出码。 0 成功，1 错误，2 需要认证或认证无效，3 超时。

生成会消耗积分。OAuth 命令集中除 video estimate 外没有逐命令的积分估算器。生成前，用 listenhub openapi subscription 查看剩余余额，并用 listenhub openapi video estimate（或 listenhub video estimate）估算视频成本。不要假设固定成本——请实时查询。

auth

管理登录会话。

listenhub auth login
listenhub auth logout
listenhub auth status [-j]

命令	说明
`login`	打开浏览器完成 OAuth。成功后将令牌写入 `~/.config/listenhub/credentials.json`（权限 `0600`）。令牌自动刷新。
`logout`	撤销令牌并删除已存储的凭证。
`status`	显示当前登录状态。接受 `-j`。

listenhub auth login
listenhub auth status

podcast

从主题和/或参考来源生成播客节目。

listenhub podcast create [options]
listenhub podcast list [options]

podcast create

标志	取值	默认	含义
`--query <text>`	字符串	—	节目的主题或提示词。
`--source-url <url>`	URL（可重复）	`[]`	用于支撑内容的参考 URL，可重复指定。
`--source-text <text>`	字符串（可重复）	`[]`	用于支撑内容的参考文本，可重复指定。
`--mode <mode>`	`quick`、`deep`、`debate`	`quick`	生成模式。
`--lang <lang>`	`en`、`zh`、`ja`	自动	输出语言。省略时从 `--query` 自动检测。
`--speaker <name>`	字符串（可重复）	—	按名称指定说话人。单人 → 单人节目；两人及以上 → 多人节目。
`--speaker-id <id>`	字符串（可重复）	—	按 inner ID 指定说话人。可替代 `--speaker`。
`--no-wait`	标志	轮询	立即返回节目 ID，不轮询。
`--timeout <seconds>`	数字	`300`	轮询超时。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub podcast create --query "AI agent trends in 2026" --mode quick

podcast list

标志	取值	默认	含义
`--page <n>`	数字	`1`	页码。
`--page-size <n>`	数字	`20`	每页条数。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub podcast list --page 1 --page-size 20

tts

用单一音色将文本转为语音。

listenhub tts create [options]
listenhub tts list [options]

tts create

标志	取值	默认	含义
`--text <text>`	字符串	—	待转语音的文本。
`--source-url <url>`	URL（可重复）	`[]`	参考 URL，可重复指定。
`--source-text <text>`	字符串（可重复）	`[]`	参考文本，可重复指定。
`--mode <mode>`	`smart`、`direct`	`smart`	`smart` 会为口播改写输入；`direct` 原样朗读。
`--lang <lang>`	`en`、`zh`、`ja`	自动	输出语言。省略时从 `--text` 自动检测。
`--speaker <name>`	字符串	—	按名称指定说话人。
`--speaker-id <id>`	字符串	—	按 inner ID 指定说话人。
`--no-wait`	标志	轮询	立即返回 ID，不轮询。
`--timeout <seconds>`	数字	`300`	轮询超时。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub tts create --text "Hello, world" --lang en

tts list

标志	取值	默认	含义
`--page <n>`	数字	`1`	页码。
`--page-size <n>`	数字	`20`	每页条数。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub tts list

explainer

生成讲解视频（带旁白的视觉片段）。

listenhub explainer create [options]
listenhub explainer list [options]

explainer create

默认开启旁白；传 --skip-audio 可生成无声视频。

标志	取值	默认	含义
`--query <text>`	字符串	—	主题或提示词。
`--source-url <url>`	URL（可重复）	`[]`	参考 URL，可重复指定。
`--source-text <text>`	字符串（可重复）	`[]`	参考文本，可重复指定。
`--mode <mode>`	`info`、`story`	`info`	生成模式。
`--lang <lang>`	`en`、`zh`、`ja`	自动	输出语言。省略时从 `--query` 自动检测。
`--speaker <name>`	字符串	—	按名称指定说话人。
`--speaker-id <id>`	字符串	—	按 inner ID 指定说话人。
`--skip-audio`	标志	`false`	跳过旁白（无声视频）。
`--image-size <size>`	`2K`、`4K`	`2K`	渲染图像分辨率。
`--aspect-ratio <ratio>`	`16:9`、`9:16`、`1:1`	`16:9`	画面宽高比。
`--style <style>`	字符串	—	视觉风格提示。
`--no-wait`	标志	轮询	立即返回 ID，不轮询。
`--timeout <seconds>`	数字	`300`	轮询超时。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub explainer create --query "How vaccines work" --mode info --aspect-ratio 16:9

explainer list

标志	取值	默认	含义
`--page <n>`	数字	`1`	页码。
`--page-size <n>`	数字	`20`	每页条数。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub explainer list

slides

从主题和/或来源生成幻灯片。

listenhub slides create [options]
listenhub slides list [options]

slides create

幻灯片默认无声。传 --no-skip-audio 可添加语音旁白。

标志	取值	默认	含义
`--query <text>`	字符串	—	主题或提示词。
`--source-url <url>`	URL（可重复）	`[]`	参考 URL，可重复指定。
`--source-text <text>`	字符串（可重复）	`[]`	参考文本，可重复指定。
`--lang <lang>`	`en`、`zh`、`ja`	自动	输出语言。省略时从 `--query` 自动检测。
`--speaker <name>`	字符串	—	按名称指定说话人（启用旁白时使用）。
`--speaker-id <id>`	字符串	—	按 inner ID 指定说话人。
`--no-skip-audio`	标志	无声	生成语音旁白（默认关闭）。
`--image-size <size>`	`2K`、`4K`	`2K`	渲染图像分辨率。
`--aspect-ratio <ratio>`	`16:9`、`9:16`、`1:1`	`16:9`	幻灯片宽高比。
`--style <style>`	字符串	—	视觉风格提示。
`--no-wait`	标志	轮询	立即返回 ID，不轮询。
`--timeout <seconds>`	数字	`300`	轮询超时。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub slides create --query "Q3 product roadmap" --no-skip-audio

slides list

标志	取值	默认	含义
`--page <n>`	数字	`1`	页码。
`--page-size <n>`	数字	`20`	每页条数。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub slides list

music

生成、转换并分析音乐。生成类子命令会轮询（默认超时 600）；分析类子命令（recognize、describe、stem）为同步执行，立即打印结果。标注为 Mureka 的子命令的参考输入仅接受本地文件（不支持 URL 透传）。

listenhub music generate [options]
listenhub music cover --audio <path-or-url> [options]
listenhub music extend --audio <path-or-url> --model <v> --continue-at <s> [options]
listenhub music remix [audio] [options]
listenhub music instrumental [options]
listenhub music soundtrack [options]
listenhub music track [audio] [options]
listenhub music recognize --audio <path> [-j]
listenhub music describe --audio <path> [-j]
listenhub music stem --audio <path> [options]
listenhub music list [options]
listenhub music get <taskId> [-j]

music generate

从文本提示词生成音乐。

标志	取值	默认	含义
`--prompt <text>`	字符串（必填）	—	音乐描述。
`--style <text>`	字符串	—	风格或氛围。
`--title <text>`	字符串	—	曲目标题。
`--instrumental`	标志	`false`	仅器乐，无人声。
`--no-wait`	标志	轮询	立即返回 ID，不轮询。
`--timeout <seconds>`	数字	`600`	轮询超时。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub music generate --prompt "Upbeat electronic dance" --style "EDM" --title "Night Drive"

music cover

从参考音频生成翻唱。--audio 接受本地文件或 URL。

标志	取值	默认	含义
`--audio <path-or-url>`	路径或 URL（必填）	—	参考音频。
`--prompt <text>`	字符串	—	音乐描述。
`--style <text>`	字符串	—	风格或氛围。
`--title <text>`	字符串	—	曲目标题。
`--instrumental`	标志	`false`	仅器乐，无人声。
`--no-wait`	标志	轮询	立即返回 ID，不轮询。
`--timeout <seconds>`	数字	`600`	轮询超时。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub music cover --audio ./original.mp3 --title "My Remix"

music extend

从参考音频续写音乐，从指定时间点继续。--audio 接受本地文件或 URL。

标志	取值	默认	含义
`--audio <path-or-url>`	路径或 URL（必填）	—	参考音频。
`--model <version>`	`V4`、`V4_5`、`V4_5PLUS`、`V4_5ALL`、`V5`、`V5_5`（必填）	—	模型版本。
`--continue-at <seconds>`	数字（必填）	—	开始续写的时间点。
`--prompt <text>`	字符串	—	歌词或描述。
`--style <text>`	字符串	—	风格或氛围。
`--title <text>`	字符串	—	曲目标题。
`--instrumental`	标志	`false`	仅器乐，无人声。
`--negative-tags <text>`	字符串	—	要排除的风格。
`--vocal-gender <gender>`	`m`、`f`	—	人声性别。
`--style-weight <weight>`	数字 `0`–`1`	—	风格引导权重。
`--weirdness <weight>`	数字 `0`–`1`	—	创意/怪异度约束。
`--audio-weight <weight>`	数字 `0`–`1`	—	输入音频影响权重。
`--no-wait`	标志	轮询	立即返回 ID，不轮询。
`--timeout <seconds>`	数字	`600`	轮询超时。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub music extend --audio ./song.mp3 --model V5 --continue-at 30

music remix

用新歌词翻唱改编已有歌曲（Mureka）。须且仅须提供一个来源：位置参数 [audio] 本地文件（.mp3/.m4a，最大 10 MB）、--audio-url 或 --provider-song-id。

标志	取值	默认	含义
`[audio]`	本地文件	—	参考音频文件（位置参数）。
`--audio-url <url>`	URL	—	以 URL 替代文件作为参考音频。
`--provider-song-id <id>`	字符串	—	以 Mureka song id 替代文件。
`--lyrics <text>`	字符串（必填）	—	改编歌曲的歌词。
`--prompt <text>`	字符串（必填）	—	音乐描述。
`--no-wait`	标志	轮询	立即返回 ID，不轮询。
`--timeout <seconds>`	数字	`600`	轮询超时。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub music remix ./original.mp3 --lyrics "New verse..." --prompt "Lo-fi hip hop"

music instrumental

生成独立器乐（Mureka）。须且仅须提供 --prompt 或 --reference-audio 之一。

标志	取值	默认	含义
`--prompt <text>`	字符串	—	音乐描述。
`--reference-audio <path>`	本地文件	—	参考音频（`.mp3`/`.m4a`，最大 10 MB）。
`--model <version>`	`auto`、`mureka-7.6`、`mureka-8`、`mureka-o2`	—	模型版本。
`--no-wait`	标志	轮询	立即返回 ID，不轮询。
`--timeout <seconds>`	数字	`600`	轮询超时。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub music instrumental --prompt "Cinematic orchestral build-up" --model mureka-8

music soundtrack

从图片或视频生成音乐（Mureka）。须且仅须提供 --image 或 --video 之一。

标志	取值	默认	含义
`--image <path>`	本地文件	—	源图片（`.jpg`/`.jpeg`/`.png`/`.webp`，最大 10 MB）。
`--video <path>`	本地文件	—	源视频（`.mp4`/`.mov`/`.avi`/`.mkv`/`.webm`，最大 10 MB）。
`--prompt <text>`	字符串	—	音乐描述。
`--model <version>`	`auto`、`mureka-7.6`、`mureka-8`、`mureka-9`、`mureka-o2`	—	模型版本。
`--no-wait`	标志	轮询	立即返回 ID，不轮询。
`--timeout <seconds>`	数字	`600`	轮询超时。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub music soundtrack --image ./cover.png --prompt "Dreamy synthwave"

music track

生成单个乐器或人声轨道（Mureka）。须且仅须提供一个来源：位置参数 [audio] 本地文件（.mp3/.m4a/.wav，最大 10 MB）或 --provider-song-id。当 --generate-type 为 Vocals 时，--lyrics 必填。

标志	取值	默认	含义
`[audio]`	本地文件	—	参考音频文件（位置参数）。
`--provider-song-id <id>`	字符串	—	以 Mureka song id 替代文件。
`--generate-type <type>`	`Vocals`、`Instrumental`、`Drums`、`Bass`、`Guitar`、`Keyboard`、`Percussion`、`Strings`、`Synth`、`FX`、`Brass`、`Woodwinds`（必填）	—	要生成的轨道类型。
`--prompt <text>`	字符串（必填）	—	音乐描述。
`--lyrics <text>`	字符串	—	歌词。`--generate-type` 为 `Vocals` 时必填。
`--vocal-gender <gender>`	`male`、`female`	—	人声性别。
`--generate-start <seconds>`	数字	—	区间起点（秒）。
`--generate-end <seconds>`	数字	—	区间终点（秒）。
`--no-wait`	标志	轮询	立即返回 ID，不轮询。
`--timeout <seconds>`	数字	`600`	轮询超时。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub music track ./song.mp3 --generate-type Drums --prompt "Punchy breakbeat"

music recognize

从音频识别带时间戳的歌词（Mureka）。同步执行，立即打印。

标志	取值	默认	含义
`--audio <path>`	本地文件（必填）	—	音频文件（`.mp3`/`.m4a`，最大 10 MB）。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub music recognize --audio ./song.mp3

music describe

分析音频——描述、标签、流派、乐器（Mureka）。同步执行。

标志	取值	默认	含义
`--audio <path>`	本地文件（必填）	—	音频文件（`.mp3`/`.m4a`，最大 10 MB）。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub music describe --audio ./song.mp3

music stem

将音频分离为音轨并返回下载 URL（Mureka）。同步执行。

标志	取值	默认	含义
`--audio <path>`	本地文件（必填）	—	音频文件（`.mp3`/`.m4a`，最大 10 MB）。
`--model <model>`	`audio-separation-1`、`audio-separation-2`	—	分离模型。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub music stem --audio ./song.mp3 --model audio-separation-2

music list

标志	取值	默认	含义
`--page <n>`	数字	`1`	页码。
`--page-size <n>`	数字	`20`	每页条数。
`--status <status>`	`pending`、`generating`、`uploading`、`success`、`failed`	—	按状态过滤。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub music list --status success

music get

标志	取值	默认	含义
`<taskId>`	字符串（必填）	—	音乐任务 ID（位置参数）。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub music get <task-id>

image

生成并管理 AI 图片。

listenhub image create --prompt <text> [options]
listenhub image list [options]
listenhub image get <id> [-j]
listenhub image delete <id...> [-j]

image create

--reference 接受本地文件或 URL，可重复，最多 5 个。

标志	取值	默认	含义
`--prompt <text>`	字符串（必填）	—	图片描述。
`--model <model>`	字符串	—	模型名称。
`--lang <lang>`	字符串	—	提示词语言提示。
`--aspect-ratio <ratio>`	字符串	`1:1`	宽高比。
`--size <size>`	`1K`、`2K`、`4K`	`2K`	图片尺寸。
`--reference <path-or-url>`	路径或 URL（可重复，最多 5）	`[]`	参考图片。
`--no-wait`	标志	轮询	立即返回 ID，不轮询。
`--timeout <seconds>`	数字	`120`	轮询超时。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub image create --prompt "a dragon in watercolor style" --reference ./sketch.png

image list

标志	取值	默认	含义
`--page <n>`	数字	`1`	页码。
`--page-size <n>`	数字	`20`	每页条数。
`--json`、`-j`	标志	`false`	JSON 输出。

image get / image delete

命令	参数	含义
`image get <id>`	图片 ID	获取图片详情。接受 `-j`。
`image delete <id...>`	一个或多个图片 ID	删除一个或多个 AI 图片。接受 `-j`。

listenhub image get <id>
listenhub image delete <id1> <id2>

video

用 SeeDance 模型生成视频。图片/视频/音频输入接受 <path-or-url>（本地文件会上传，URL 透传）。

listenhub video create --prompt <text> [options]
listenhub video get <taskId> [-j]
listenhub video list [options]
listenhub video estimate [options]

video create

标志	取值	默认	含义
`--prompt <text>`	字符串（必填）	—	视频描述。
`--model <model>`	`happyhorse`、`doubao-seedance-2-pro`、`doubao-seedance-2-fast`	`happyhorse`	生成模型。
`--resolution <res>`	`480p`、`720p`、`1080p`	—	输出分辨率。
`--ratio <ratio>`	`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`4:5`、`5:4`	—	宽高比。
`--duration <seconds>`	数字 `3`–`15`	—	视频时长。
`--first-frame <path-or-url>`	路径或 URL	—	首帧图片。
`--last-frame <path-or-url>`	路径或 URL	—	尾帧图片（需配合 `--first-frame`）。
`--reference-image <path-or-url>`	路径或 URL（可重复，最多 9）	`[]`	参考图片。
`--reference-video <path-or-url>`	路径或 URL（可重复，最多 3）	`[]`	参考视频。
`--reference-audio <path-or-url>`	路径或 URL（可重复，最多 3）	`[]`	参考音频。
`--input-video-duration <seconds>`	数字 `2`–`15`	—	参考视频时长。配合 `--reference-video` 时必填。
`--no-generate-audio`	标志	开启音频	关闭音频生成。
`--audio-setting <mode>`	`auto`、`origin`	—	视频编辑场景的音频处理方式。
`--seed <number>`	数字 `-1`–`4294967295`	—	随机种子。
`--no-wait`	标志	轮询	立即返回 ID，不轮询。
`--timeout <seconds>`	数字	`1200`	轮询超时。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub video create --prompt "A cat playing piano" --resolution 720p --duration 5

video estimate

创建前估算积分成本。

标志	取值	默认	含义
`--model <model>`	字符串（必填）	—	模型名称。
`--resolution <res>`	字符串（必填）	—	分辨率。
`--duration <seconds>`	数字（必填）	—	时长。
`--ratio <ratio>`	字符串	`16:9`	宽高比。
`--has-video-input`	标志	`false`	是否带参考视频输入。
`--input-video-duration <seconds>`	数字	—	参考视频时长。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub video estimate --model doubao-seedance-2-pro --resolution 1080p --duration 10

命令	标志	含义
`video get <taskId>`	`-j`	获取视频任务详情。
`video list`	`--page`、`--page-size`、`--status`（`pending`/`generating`/`uploading`/`success`/`failed`）、`-j`	列出视频任务。

listenhub video list --status success
listenhub video get <task-id>

speakers

列出账户可用的音色。

listenhub speakers list [options]

标志	取值	默认	含义
`--lang <lang>`	`en`、`zh`、`ja`	—	按语言过滤。
`--json`、`-j`	标志	`false`	JSON 输出。

打印包含 Name、ID、Gender、Personality 的表格。ID 列即创建类命令中传给 --speaker-id 的值。

listenhub speakers list --lang en

lyrics

从提示词生成歌词。

listenhub lyrics generate --prompt <text> [options]
listenhub lyrics list [options]
listenhub lyrics get <taskId> [-j]

lyrics generate

标志	取值	默认	含义
`--prompt <text>`	字符串（必填，最多 200 字符）	—	歌词描述。
`--no-wait`	标志	轮询	立即返回 ID，不轮询。
`--timeout <seconds>`	数字	`120`	轮询超时。
`--json`、`-j`	标志	`false`	JSON 输出。

listenhub lyrics generate --prompt "A hopeful anthem about new beginnings"

lyrics list / lyrics get

命令	标志	含义
`lyrics list`	`--page`、`--page-size`、`--status`（`pending`/`generating`/`success`/`failed`）、`-j`	列出歌词任务。
`lyrics get <taskId>`	`-j`	获取歌词任务详情。

listenhub lyrics list --status success
listenhub lyrics get <task-id>

creation

按 ID 获取或删除任意创作（节目、图片或其他生成项）。

listenhub creation get <id> [-j]
listenhub creation delete <id...> [-j]

命令	参数	含义
`creation get <id>`	创作 ID	获取创作详情。接受 `-j`。
`creation delete <id...>`	一个或多个 ID	删除一个或多个创作。接受 `-j`。

listenhub creation get <id>
listenhub creation delete <id1> <id2>

CLI 快速开始

认证

OpenAPI 命令

JavaScript SDK

On this page