Freebeat Generate

# Freebeat Generate

Use this skill when the user wants a single Freebeat entry point for image generation, image editing, and text-to-video generation.

## Before running CLI commands

Freebeat CLI is an npm package and authenticated API client. Install or refresh it first:

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

The user must provide a Freebeat API key before generation. Use one of these patterns:

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

Validate credentials before starting a paid or long-running workflow:

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

Do not paste or log the raw API key. Ask the user to provide it in their terminal, secret store, or environment variable.

## Supported model values

Image models:

- 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

Video models:

- 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

Always inspect the model before using it:

~~~bash
freebeat models list image
freebeat models list video
freebeat models help --name <model>
~~~

## Generate images

~~~bash
freebeat image generate --model 80 --prompt "neon city album cover" --size 1024x1024 --count 1 --wait
freebeat image generate --model 108 --prompt "cinematic album cover for an electronic single" --resolution 1024x1024 --quality medium --wait
~~~

## Edit images

~~~bash
freebeat image edit --model 80 --image ref.png --prompt "make it cinematic and campaign-ready" --wait
freebeat image edit --model 108 --image https://cdn.example.com/ref.png --prompt "make it cinematic" --resolution 1024x1024 --quality medium --wait
~~~

## Generate video

~~~bash
freebeat video generate --model pixverse-c1 --prompt "fast cuts, neon city, kinetic camera" --duration 5 --resolution 720p --aspect-ratio 16:9 --wait
freebeat video generate --model sora-2-pro --prompt "surreal night drive through a glowing music festival" --duration 8 --resolution 720p --aspect-ratio 16:9 --wait
freebeat video generate --model seedance-2.0 --prompt "energetic dance performance with quick lighting changes" --duration 5 --resolution 720p --aspect-ratio 9:16 --wait
~~~

## Model-specific notes

- GPT-Image 2 uses --model 108. On freebeat-cli 0.1.2 or newer, the CLI sends --quality medium and --resolution 1024x1024 by default when omitted. You can pass --resolution explicitly, for example 1024x1024, 1024x1536, or 1920x1088.
- Pixverse C1 and Pixverse V6 support --generate-audio.
- Kling V3 4K requires --resolution 4k.
- Sora 2 Pro supports duration 4, 8, or 12.
- SeedDance 2.0 and SeedDance 2.0 Fast support 720p output.

## Check progress

Open RPC image and video commands return a batch id and serial number. Legacy MV and effect commands return a 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>
~~~

Use --json when another agent, script, or CI job needs to parse task ids, batch ids, serial numbers, result URLs, credits, or statuses.