Flatkey CLI for media teams

One CLI for every media generation job from brief to files

Generate images, videos, voiceovers, sound effects, music, and text from one Flatkey balance. Use it manually from the terminal, or wire it into Claude Code, Codex, Cursor, OpenClaw, and other agents.

Install CLIGet API key
1API key for every command
4media types from one workflow
JSONclean output for agents
Flatkeyflatkey-cli
GitHub
Install and create$
npm i -g @flatkey-ai/cli
export FLATKEY_API_KEY=<your-flatkey-api-key>

flatkey image generate --prompt "editorial cover, neon city at dawn" -o cover.png
flatkey video generate --prompt "cinematic product launch clip" --model seedance2 -o launch.mp4
flatkey audio generate --prompt "Product launch voiceover" -o voice.mp3
flatkey credits --json
Production workflow

From creative brief to local files

Flatkey CLI gives media teams a repeatable production surface. Generate stills, video clips, voiceover, music, SFX, and copy without switching between dashboards or rebuilding the same prompt by hand.

Video generation

Create 9:16 clips, product reveals, first-frame/last-frame transitions, and reference-image video jobs from local files.

Image generation

Make campaign stills, thumbnails, product concepts, covers, and visual options with saved local outputs.

Audio generation

Generate voiceover, sound effects, and music beds from the same CLI workflow.

Text generation

Draft hooks, titles, captions, scripts, and prompt variants before generating media.

K

One key. One balance. One ledger.

Every command runs through Flatkey. Teams can see credits, model usage, request history, and cost behavior in one place instead of spreading media production across separate subscriptions.

  • Check credits before a run.
  • Use dry-run before spending.
  • Keep generated files and request output tied to the same job folder.
$

Human-friendly. Agent-ready.

Run Flatkey directly when you want control. Add --json, --dry-run, and --output when an AI agent or script needs predictable behavior.

  • Predictable stdout for automation.
  • Local outputs for editing and review.
  • Model discovery before choosing a generation route.
automation$
flatkey video generate \
  --prompt "UGC product demo, handheld, 9:16" \
  --model seedance2 \
  --ratio 9:16 \
  --dry-run \
  --json

What media teams run with it

Batch ad concepts

Generate multiple hooks, thumbnails, clips, and voiceover options for a campaign folder.

Product launch assets

Turn one brief into hero images, short videos, captions, and audio in one local workflow.

Localization

Create region-specific prompts, voiceovers, captions, and creative variants for US, Brazil, Japan, and other markets.

AI agent production

Let Claude Code, Codex, or another agent plan the creative, run Flatkey commands, save files, and report cost.

CLI questions

Is Flatkey CLI only for developers?

No. It is a terminal workflow, but the job is media production: generate files, compare outputs, and keep costs visible.

Does it replace creative suites?

No. Use creative suites when you need their visual editor. Use Flatkey CLI when you need repeatable generation, local outputs, automation, and one balance across models.

Can it generate video from local images?

Yes. The CLI can upload local reference images and use image, first-frame, or last-frame inputs for supported video models.

Turn one brief into a production run

Install Flatkey CLI, create a key, and start generating media files from one balance.

Install CLICreate API key