Skill

特效模板

发现 Freebeat 特效模板，并基于音乐、图片和提示词生成特效视频片段。

freebeat CLI

立即使用已预置

社区总使用量

3积分使用量

7总生成次数

关于 Skill

skill.md

# 特效模板

当用户需要 Freebeat 特效模板片段，而不是普通文生视频模型任务时，使用这个 Skill。

## 执行 CLI 命令前

Freebeat CLI 是 npm 包，也是需要认证的 API 客户端。请先安装或更新：

~~~bash
npm install -g freebeat-cli@latest
freebeat --help
~~~

生成前必须提供 Freebeat API key。可以使用以下任一方式：

~~~bash
freebeat auth set-api-key
printf '%s' "$FREEBEAT_API_KEY" | freebeat auth set-api-key --stdin
freebeat --api-key <apiKey> <command>
~~~

开始付费或长时间工作流前，先验证凭证：

~~~bash
freebeat auth show
freebeat auth test
~~~

不要粘贴或记录原始 API key。请让用户在终端、secret store 或环境变量中提供。

## 发现模板

~~~bash
freebeat effects list
freebeat effects list --json
~~~

## 提交特效任务

~~~bash
freebeat effect submit --effect-id <effectId> --music-id <musicId> --image-url <imageUrl> --prompt "动漫光效" --wait
~~~

## 使用模板默认值执行

~~~bash
freebeat effect run --effect-id <effectId> --prompt "动漫光效" --wait
freebeat effect run --effect-id <effectId> --audio song.mp3 --image ref.png --prompt "动漫光效" --wait
~~~

特效命令支持 --audio、--image、--watermark 和 --wait。当模板已有默认素材且用户想快速生成时，可使用 effect run。

## 检查进度

Open RPC 图片和视频命令会返回 batch id 和 serial number。旧版 MV 和特效命令会返回 task id。

~~~bash
freebeat task status <batch-id>
freebeat task status <batch-id> --serial-no <serial-no>
freebeat task wait <batch-id> --serial-no <serial-no>
freebeat task status <task-id>
freebeat task wait <task-id>
freebeat task result <task-id>
~~~

如果 Agent、脚本或 CI 需要解析 task id、batch id、serial number、结果 URL、积分或状态，请使用 --json。