genmedia

Original：🇺🇸 English
Translated

Use the genmedia CLI to search, inspect, run, and manage 1200+ fal.ai model endpoints. Trigger when the user mentions "genmedia", "fal CLI", or asks to "search models", "run a model", "fetch schema", "check pricing", "upload to fal", "queue async job", "track request", or any direct interaction with the fal.ai endpoint catalog. This is the foundational skill. Every other fal.ai-related skill in this repo executes its work through genmedia commands. Use `--json` whenever the output will be parsed by an agent.

4installs
Sourcefal-ai-community/skills
Added on

NPX Install

npx skill4agent add fal-ai-community/skills genmedia

Tags

Translated version includes tags in frontmatter
genmedia-clifal-aimodel-endpointsai-cli-toolsasync-job-management

SKILL.md Content

View Translation Comparison →

genmedia CLI: fal.ai endpoint runner

genmedia
is the agent-first CLI for fal.ai. It works in a terminal for humans (pretty output) and equally well for agents (structured JSON when piped or with 
--json
). All other skills in this repo call 
genmedia
for execution, they do not wrap the fal.ai HTTP API directly.
For the full command surface (every flag, every option, every example), see references/full-reference.md.

Critical rules

  1. Always use 
    --json
    when an agent will read the output.     Pretty mode is for humans only.
  2. Never invent endpoint IDs. Use 
    genmedia models "<query>"
    to discover, 
    genmedia models --endpoint_id <id>
    to verify.
  3. Inspect schema before running. 
    genmedia schema <endpoint_id> --json
    shows the exact field names. Guessed flags fail with 422.
  4. Save files with 
    --download
    , not curl.     The CLI handles authentication, naming, and file format detection.
  5. Use 
    --async
    for long-running generation.     Image work usually completes inline; video/audio/3D usually need queue + status polling.

Command index

CommandPurpose
genmedia setup
Configure API key, output mode, auto-update
genmedia models <query>
Search the catalog (or 
--category
, or 
--endpoint_id
)
genmedia schema <endpoint_id>
Inspect inputs/outputs (compact or 
--format openapi
)
genmedia run <endpoint_id> --<param> <value>
Execute a model
genmedia status <endpoint_id> <request_id>
Poll an async job (with 
--result
, 
--logs
, 
--cancel
, 
--download
)
genmedia upload <path-or-url>
Upload a local file or remote URL to the fal.ai CDN
genmedia pricing <endpoint_id>
Check cost per call
genmedia docs <query>
Search fal.ai documentation
genmedia init
Install the default skill bundle into 
.agents/skills/
or 
.claude/skills/
`genmedia skills <listinstall
genmedia version
/ 
genmedia update
Check or apply CLI updates

Quick patterns

Run a model and download the result

bash
genmedia run fal-ai/flux/dev \
 --prompt "a cat on the moon" \
 --download "./out/{request_id}_{index}.{ext}" \
 --json

Async + poll

bash
SUBMIT=$(genmedia run fal-ai/veo3.1 --prompt "a dog running" --async --json)
REQ=$(echo "$SUBMIT" | jq -r '.request_id')
genmedia status fal-ai/veo3.1 "$REQ" \
 --download "./out/{request_id}_{index}.{ext}" \
 --json

Upload then run

bash
URL=$(genmedia upload ./photo.jpg --json | jq -r '.url')
genmedia run fal-ai/nano-banana-pro/edit \
 --image_urls "$URL" \
 --prompt "make the sky stormy" \
 --download "./out/{request_id}_{index}.{ext}" \
 --json

Discover when the user names a fuzzy task

bash
genmedia models "background removal product image" --json
genmedia models --category text-to-video --limit 5 --json
genmedia docs "webhook callbacks" --json

Setup (first-time only)

If 
genmedia
is not installed:
bash
curl https://genmedia.sh/install -fsS | bash # Linux / macOS
irm https://genmedia.sh/install.ps1 | iex # Windows PowerShell
genmedia setup --non-interactive --api-key "$FAL_KEY"
For full setup details (output modes, auto-update, 
.env
loading) see full-reference.md.