关于 sjinn-audio-generation
sjinn-audio-generation 是通过 SJinn 根据文本生成音频的技能,也可使用参考音频或图片引导生成。它说明模型参数、异步任务流程及结果处理方式。
主要功能
- 01根据文本提示词生成音频
- 02使用最多三个参考音频
- 03使用参考图片引导生成
- 04异步运行生成任务
- 05返回任务和音频 URL
适用场景
- 01根据描述制作语音音频
- 02参照音频片段生成内容
- 03制作匹配场景的背景音乐
- 04按需将生成音频保存到本地
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ sjinn-ai/ skills --skill sjinn-audio-generation安装后在 Claude Code 中输入/sjinn-audio-generation确认已加载。
详细介绍
SJinn 音频生成
当用户想通过 SJinn 根据文本生成音频(可选使用参考音频或参考图像引导)时,请使用此技能。
前置条件
生成前,快速验证 CLI 和登录状态:
sjinn --version
sjinn auth whoami
如果任一命令失败,请先使用 sjinn-setup。
模型和参数
目前仅提供一种音频模型:
seed-audio-1-0(ByteDance 的 Seed Audio 1.0)——生成 .mp3 文件。
| 参数 | 必需 | seed-audio-1-0 的支持情况 |
|---|---|---|
--prompt | 是 | 对音频的文本描述。按传入 --audio-urls 的顺序,在提示词中使用 @Audio1 / @Audio2 / @Audio3 引用参考音频。 |
--audio-urls | 否 | 最多 3 个参考音频文件或 URL(mp3、m4a、wav),以逗号分隔。不能与 --image-urls 同时使用。 |
--image-urls | 否 | 单张参考图像(jpg、jpeg、png、webp)。不能与 --audio-urls 同时使用。 |
参考音频和参考图像不能同时使用。
工作流
- 优先使用 JSON 输出,以便轻松解析结果。
- 对于耗时较长的任务,请使用
--async,除非用户明确希望等待。 - 只有在用户要求将结果保存到本地时,才使用
--download [path]。
命令
文本转音频:
sjinn audio generate --prompt "a calm female voice reading a bedtime story" --model seed-audio-1-0 --async --json
使用参考音频(在提示词中引用):
sjinn audio generate --prompt "narrate in the style of @Audio1 with the energy of @Audio2" --audio-urls "./ref-a.mp3,./ref-b.wav" --model seed-audio-1-0 --json
使用参考图像:
sjinn audio generate --prompt "background music matching the mood of this scene" --image-urls "./scene.png" --model seed-audio-1-0 --async --json
将结果下载到本地:
sjinn audio generate --prompt "short upbeat jingle" --model seed-audio-1-0 --download ./jingle.mp3 --json
输出处理
成功时,返回任务 ID、主要 URL、任何其他 URL、模型和耗时。如果 status 为 created,请告知用户使用 sjinn-task-status 查询任务。
发生错误时,清楚地概述 CLI 错误;仅当错误表明 CLI 缺失或未通过身份验证时,才建议使用 sjinn-setup。
评论
支持 Markdown