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 statuspodcast
从主题和/或参考来源生成播客节目。
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 quickpodcast list
| 标志 | 取值 | 默认 | 含义 |
|---|---|---|---|
--page <n> | 数字 | 1 | 页码。 |
--page-size <n> | 数字 | 20 | 每页条数。 |
--json、-j | 标志 | false | JSON 输出。 |
listenhub podcast list --page 1 --page-size 20tts
用单一音色将文本转为语音。
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 entts list
| 标志 | 取值 | 默认 | 含义 |
|---|---|---|---|
--page <n> | 数字 | 1 | 页码。 |
--page-size <n> | 数字 | 20 | 每页条数。 |
--json、-j | 标志 | false | JSON 输出。 |
listenhub tts listvoice-clone
用当前登录账号克隆自己的音色,并管理由此产生的私有音色。只支持 upload 模式——交互式录音链路在网页端。语言支持 zh 与 en。
套餐周期配额内确认不扣费,超出后每次 300 积分,且只有传了 --use-credits 才会真的扣。
| 命令 | 说明 |
|---|---|
voice-clone create | 上传 1–6 个参考音频文件并创建克隆任务。 |
voice-clone get <taskId> | 查看任务状态。 |
voice-clone confirm | 把已完成的任务确认成私有音色。 |
voice-clone speakers | 列出私有音色、配额与剩余确认次数。 |
voice-clone speaker <speakerId> | 查看单个私有音色。 |
voice-clone update <speakerId> | 改音色名称或性别。 |
voice-clone delete <speakerId> | 删除音色并释放一个名额。 |
voice-clone create 选项:
| 选项 | 默认 | 说明 |
|---|---|---|
--file <path...> | 必填 | 1–6 个本地参考音频文件。 |
--lang <lang> | 必填 | zh 或 en。 |
--no-wait、--timeout <seconds>(600)、--json | — | 标准异步参数。 |
voice-clone confirm 接受 --task-id <id>、--name <name>(最长 50 字符)、--gender <male\|female\|other>,以及可选的 --use-credits。voice-clone update <speakerId> 接受 --name 和/或 --gender(至少一个)。
# 先克隆,试听满意后再确认
listenhub voice-clone create --file ./reference.mp3 --lang zh
listenhub voice-clone confirm \
--task-id 6915bde9cca4d3c8ecb3eaf5 --name "我的音色" --gender female
# speakers 列出的 speaker ID 可以用在任何需要音色的地方
listenhub voice-clone speakers
listenhub tts create --text "这句话由我自己的克隆音色朗读。" --speaker-id voice-clone-6915bde9cca4d3c8ecb3eaf5explainer
生成讲解视频(带旁白的视觉片段)。
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:9explainer list
| 标志 | 取值 | 默认 | 含义 |
|---|---|---|---|
--page <n> | 数字 | 1 | 页码。 |
--page-size <n> | 数字 | 20 | 每页条数。 |
--json、-j | 标志 | false | JSON 输出。 |
listenhub explainer listslides
从主题和/或来源生成幻灯片。
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-audioslides list
| 标志 | 取值 | 默认 | 含义 |
|---|---|---|---|
--page <n> | 数字 | 1 | 页码。 |
--page-size <n> | 数字 | 20 | 每页条数。 |
--json、-j | 标志 | false | JSON 输出。 |
listenhub slides listmusic
生成、转换并分析音乐。生成类子命令会轮询(默认超时 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 30music 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-8music 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.mp3music describe
分析音频——描述、标签、流派、乐器(Mureka)。同步执行。
| 标志 | 取值 | 默认 | 含义 |
|---|---|---|---|
--audio <path> | 本地文件(必填) | — | 音频文件(.mp3/.m4a,最大 10 MB)。 |
--json、-j | 标志 | false | JSON 输出。 |
listenhub music describe --audio ./song.mp3music 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-2music list
| 标志 | 取值 | 默认 | 含义 |
|---|---|---|---|
--page <n> | 数字 | 1 | 页码。 |
--page-size <n> | 数字 | 20 | 每页条数。 |
--status <status> | pending、generating、uploading、success、failed | — | 按状态过滤。 |
--json、-j | 标志 | false | JSON 输出。 |
listenhub music list --status successmusic 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.pngimage 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 5video 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 10video get / video list
| 命令 | 标志 | 含义 |
|---|---|---|
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 的值。
这条命令需要先登录。想免鉴权查同一份目录,或者把它一次性交给 agent,抓 listenhub.ai/voices.txt 即可——里面是全部官方音色的 ID、语言、性别和标签。listenhub.ai/voices 是同一份目录,可以试听。
listenhub speakers list --lang enlyrics
从提示词生成歌词。
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>