Skill

影片工作室

使用 Pixverse、Sora、Kling、SeedDance、Wan 和 HappyHorse 生成文生影片批次。

freebeat CLI

立即使用已預置

社群總使用量

157 557點數使用量

26 946總生成次數

關於 Skill

skill.md

# 影片工作室

當使用者需要透過 Freebeat CLI 進行文生影片時，使用這個 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 或環境變數中提供。

## 支援的影片模型

- Pixverse C1: --model pixverse-c1 or 103
- Pixverse V6: --model pixverse-v6 or 94
- Sora 2 Pro: --model sora-2-pro or 56
- Kling V3 4K: --model kling-v3-4k or 112
- SeedDance 2.0: --model seedance-2.0 or 102
- SeedDance 2.0 Fast: --model seedance-2.0-fast or 101
- Wan V2.7 Video: --model wan-v2.7-video or 104
- HappyHorse: --model happy-horse or 111

生成前先查看一個模型:

~~~bash
freebeat models help --name pixverse-c1
~~~

## 生成影片

~~~bash
freebeat video generate --model pixverse-c1 --prompt "快速剪輯、霓虹城市、動態鏡頭" --duration 5 --resolution 720p --aspect-ratio 16:9 --wait
freebeat video generate --model pixverse-v6 --prompt "大幅運鏡的戲劇化舞台表演" --duration 5 --resolution 720p --generate-audio --wait
freebeat video generate --model sora-2-pro --prompt "穿越發光音樂節的超現實夜間行車" --duration 8 --resolution 720p --aspect-ratio 16:9 --wait
freebeat video generate --model kling-v3-4k --prompt "雷射燈下舞者的 4K 音樂影片場景" --duration 5 --resolution 4k --aspect-ratio 16:9 --wait
freebeat video generate --model seedance-2.0-fast --prompt "彩色舞台燈光下的快速舞蹈蒙太奇" --duration 5 --resolution 720p --aspect-ratio 9:16 --wait
~~~

## 模型限制

- Pixverse C1: duration 1-15, 360p|540p|720p|1080p, supports --generate-audio.
- Pixverse V6: duration 5-15, 720p|1080p, supports --generate-audio.
- Sora 2 Pro: duration 4|8|12, 720p|1080p, aspect ratio auto|16:9|9:16.
- Kling V3 4K: duration 3-15, resolution 4k.
- SeedDance models: duration 4-15, resolution 720p.
- Wan V2.7 Video: duration 2-15, 720p|1080p.
- HappyHorse: duration 3-15, 720p|1080p.

## 檢查進度

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。