Video

Use cue video to generate a clip. Generation takes minutes, so a run through the Cue backend becomes a job you can list and check rather than a progress bar you sit in front of.

The Cue backend is the default provider, so it uses your Cue account and credits with no vendor key of your own.

Core Commands

cue video -h
cue video "a cat walking through a garden"
cue video "sunrise timelapse" -o /tmp/sunrise.mp4
cue video list
cue video status <job_id>
cue video models

Tracking a Job

cue video list --status completed --limit 5 --json
cue video status abc123-def456

cue video list shows the job id, status, provider, prompt, cost, and creation time, so a run started earlier can be collected without keeping the terminal open.

Which Models Are Available

cue video models
cue video models --json

The output marks the default model per provider. Cost between the cheapest and the dearest model spans more than tenfold, so the default is chosen for you rather than left as a per-call decision. Pick a different one with --model:

cue video "a daisy field" --provider seedance --model v2

Starting From an Image

The default Cue backend starts a clip from a first frame and carries a subject in from references, on your Cue credits with no vendor key of your own:

• --image (also --first-frame) makes the clip open on an image you already have.
• --reference carries a subject across the clip from one or more images.

cue video "the apple slowly rotating" --image apple.jpg      # start from a first frame
cue video "this character waves hello" --reference face.jpg  # carry a subject in

--last-frame has no equivalent on the Cue backend, so pinning where a clip ends still needs a direct provider and that vendor's key:

cue video "product reel" --provider veo3 --image start.jpg --last-frame end.jpg
cue video "animate avatar" --provider seedance --image avatar.png --audio

Direct Providers

--provider can bypass the Cue backend and call a vendor with your own key. This is the escape hatch for someone already paying that vendor, not the normal path.

The legacy spelling seeddance is still accepted.

cue video models --provider seedance          # live Seedance models from Ark
cue video models --provider seedance --json

Set the keys once:

cue skill env set GEMINI_API_KEY <your-key>
cue skill env set ARK_API_KEY <your-key>
cue skill env list                             # verify configured keys

Run cue video -h for the current provider and flag list.