Freebeat 生成

# Freebeat 生成

当用户需要用同一个 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 或环境变量中提供。

## 支持的模型值

图片模型:

- Nano Banana 2: --model 80
- Nano Banana Pro: --model 64
- Wan V2.7 Image: --model 99
- Wan V2.7 Pro Image: --model 100
- GPT-Image 2: --model 108

视频模型:

- 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 list image
freebeat models list video
freebeat models help --name <model>
~~~

## 生成图片

~~~bash
freebeat image generate --model 80 --prompt "霓虹城市专辑封面" --size 1024x1024 --count 1 --wait
freebeat image generate --model 108 --prompt "电子单曲的电影感专辑封面" --resolution 1024x1024 --quality medium --wait
~~~

## 编辑图片

~~~bash
freebeat image edit --model 80 --image ref.png --prompt "让它更有电影感并适合营销活动" --wait
freebeat image edit --model 108 --image https://cdn.example.com/ref.png --prompt "让它更有电影感" --resolution 1024x1024 --quality medium --wait
~~~

## 生成视频

~~~bash
freebeat video generate --model pixverse-c1 --prompt "快速剪辑、霓虹城市、动态镜头" --duration 5 --resolution 720p --aspect-ratio 16:9 --wait
freebeat video generate --model sora-2-pro --prompt "穿越发光音乐节的超现实夜间行车" --duration 8 --resolution 720p --aspect-ratio 16:9 --wait
freebeat video generate --model seedance-2.0 --prompt "灯光快速变化的高能舞蹈表演" --duration 5 --resolution 720p --aspect-ratio 9:16 --wait
~~~

## 模型注意事项

- GPT-Image 2 使用 --model 108。freebeat-cli 0.1.2 或更新版本中，省略时 CLI 会默认发送 --quality medium 和 --resolution 1024x1024。也可以明确传入 --resolution，例如 1024x1024、1024x1536 或 1920x1088。
- Pixverse C1 和 Pixverse V6 支持 --generate-audio。
- Kling V3 4K 需要 --resolution 4k。
- Sora 2 Pro 支持 duration 4、8 或 12。
- SeedDance 2.0 和 SeedDance 2.0 Fast 支持 720p 输出。

## 检查进度

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。