前言¶

做内容或原型时，图像、短视频、配乐、旁白往往要换好几套工具，还要自己把素材在工具之间搬来搬去。若希望 Agent 能在同一条对话里，从一句话或已有素材出发，连续完成多种媒介的创作，就需要把能力收敛到一个可安装的 Skill，而不是每次临时拼凑提示词。

下面介绍 SkillHub 上的 AI 图像视频音乐创作（坐标 @beatra-ai/beatra-ai），以及如何在本地 Agent 中安装与使用。

这是什么¶

AI 图像视频音乐创作 是发布者 beatra 在 SkillHub 上架的企业来源（enterprise）Skill，分类为 design-media，当前版本 1.0.0。

官方简介将其定位为：把图像、视频、音乐、语音四类创作能力一次装齐；既支持从一句话直接生成，也支持带上自己的图片、素材或音频继续创作，并在同一个对话里跨媒介完成整套内容。

SkillHub 页面：https://www.skillhub.cn/skills/beatra-ai/beatra-ai
技能元数据地址：https://api.skillhub.cn/beatra-ai/beatra-ai

（页面数据：评分 100000，下载 867；标签含 requires_api_key=true，表示使用前需要配置 API Key。）

核心功能¶

以下能力均来自 SkillHub 官方简介，未在资料中出现的具体模型名、接口名不展开。

1. 图像创作：可从文本描述生成，也可基于用户提供的图片继续处理或延展。
2. 视频创作：可与图像、素材衔接，在同一工作流里产出视频类内容。
3. 音乐创作：支持生成或配合项目需要的音乐素材。
4. 语音创作：支持语音类输出，与旁白、解说等场景对齐。
5. 跨媒介同对话：不必为每一类媒介单独开新会话；在一条对话里串联图像、视频、音乐、语音，减少上下文断裂。

安装与启用¶

安装流程遵循 SkillHub 通用说明（https://skillhub.cn/install/skillhub.md）。先做环境检查，再把 Skill 装进当前 Agent 实际读取的 skills 目录。

1. 检查或安装 SkillHub CLI¶

command -v skillhub && skillhub --version

若未安装，可按官方脚本安装（完整安装或仅 CLI）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2. 安装本 Skill¶

SkillHub 页面给出的安装提示为：根据上述安装文档，安装 @beatra-ai/beatra-ai。命令行侧需用 --dir 指向当前环境的 skills 目录，否则默认落在 ./skills/ 且 Agent 可能无法识别。

skillhub search beatra-ai
skillhub install @beatra-ai/beatra-ai --dir <你的 Agent skills 目录>

常用目录示例（以官方文档为准，按你实际使用的客户端选择其一）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装或更新 Skill 后，按你所用客户端的要求重启或重新加载 Agent，使新 Skill 生效。

3. API Key¶

Skill 标签为 requires_api_key=true。具体环境变量名、配置入口以安装包内 SKILL.md 及 SkillHub 安装后的说明为准；在 Key 未配置完成前，不要假设生成类调用可用。

典型用法¶

官方未在公开页面提供逐步复制的命令示例，可复现的用法边界如下。

1. 完成 CLI 安装，并将 @beatra-ai/beatra-ai 装入当前 Agent 的 skills 目录。
2. 在对话中用自然语言说明目标，例如：先出一张概念图，再基于该图做短视频，并配上背景音乐或旁白。
3. 若已有素材，在对话中附上图片、音频或其它文件，要求在同一上下文中继续生成或改编。
4. 让 Agent 按 Skill 内指引调用 Beatra 相关能力；跨媒介步骤保持在同一会话中完成，避免拆成多个互不关联的任务。

更细的工具名、计费或任务轮询规则，以安装后 Skill 包内文档为准；本文不引用未随本 Skill 官方页发布的接口细节。

适用场景与注意¶

适合谁

• 需要在 Agent 对话里快速试创意、做多媒体原型或营销草稿的开发者、设计师、内容作者。
• 希望减少「画图一个站、剪辑一个站、配乐又一个站」的切换成本，用统一 Skill 覆盖图像、视频、音乐、语音的团队。

限制与注意

• 依赖 SkillHub CLI 与网络；沙箱或限网环境需按官方说明放开安装脚本的访问。
• 必须配置 API Key（requires_api_key=true）；企业来源 Skill，使用前确认账号与合规要求。
• 生成类能力通常涉及外部服务与配额；以 Skill 内及 Beatra 侧实际返回为准。
• SkillHub 上 .md 直链若提示「Skill 未找到」，以技能详情页 https://www.skillhub.cn/skills/beatra-ai/beatra-ai 与安装包内容为准。

结尾¶

AI 图像视频音乐创作 把图像、视频、音乐、语音四类能力收进一个 Skill，并强调「一句话或自带素材」以及「同对话跨媒介」的工作方式。若你正在 SkillHub 上选型多媒体类 Skill，可从官方页查看说明并安装 @beatra-ai/beatra-ai：

• https://www.skillhub.cn/skills/beatra-ai/beatra-ai
• https://api.skillhub.cn/beatra-ai/beatra-ai