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。