Instructions for using the genmedia command-line tool to run fal.ai models that generate or transform images, video, and audio. The workflow covers finding a model, checking its inputs, uploading files, running jobs, and saving results.

Use it to generate, convert, upscale, or restyle media through fal.ai models, including downloading the resulting files.

It explains how to select a suitable model and supply the inputs it requires, including how to handle jobs that take longer to finish. This avoids guessing model parameters or result-handling steps.

genmedia — Skill for Claude Code and Codex by fal-ai-community

Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo

git clone --depth 1 https://github.com/fal-ai-community/genmedia-cli

agentmods

npx agentmods add skills/fal-ai-community/genmedia-cli/genmedia

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/fal-ai-community/genmedia-cli/genmedia/github.svg)](https://agentmods.dev/skills/fal-ai-community/genmedia-cli/genmedia)

Your own site

<a href="https://agentmods.dev/skills/fal-ai-community/genmedia-cli/genmedia"><img src="https://agentmods.dev/badge/skills/fal-ai-community/genmedia-cli/genmedia/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/fal-ai-community/genmedia-cli/genmedia"><img src="https://agentmods.dev/badge/skills/fal-ai-community/genmedia-cli/genmedia.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 72 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,611 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00072	$0.01611
Opus 5.5	$0.00029	$0.00644
Sonnet 5.5	$0.00014	$0.00322
Haiku 4.5	$0.00007	$0.00161

Measured 1mo ago against content hash 87549d3978d8, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

genmedia scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

**not** `curl` the URLs yourself; use the flag.

.agents/skills/genmedia/SKILL.md · 164 lines

How it starts

The opening of the file, as written. The whole thing — 164 lines — stays where its author put it; the contents beside it link to each section on GitHub.

genmedia workflow

Use this skill when the user wants to execute a fal.ai model — either by task description (e.g. "generate a video of a dog running") or by a specific endpoint_id (e.g. fal-ai/flux/dev). Load genmedia-ref alongside this skill for the full command reference.

Steps

Discover — If no endpoint_id is given, search for a suitable model:
```
genmedia models "<task>" --json
```
Inspect — Get the model's input parameters:
```
genmedia schema <endpoint_id> --json
```
Read all required fields before running.
Upload files (if inputs include images/video/audio):
```
genmedia upload <local_file_or_url> --json
```
Use the returned url as the parameter value.

Run the model:

Fast model (completes in seconds):

genmedia run <endpoint_id> --<param> <value> ... --json

Slow model (video generation, large jobs):

genmedia run <endpoint_id> --<param> <value> ... --async --json
genmedia status <endpoint_id> <request_id> --result --json

Save outputs — when the user expects files on disk, add --download to run or status. The CLI writes every media URL from the result to the filesystem and returns the local paths in downloaded_files[]. Do not curl the URLs yourself; use the flag.
```
genmedia run fal-ai/flux/dev --prompt "a cat" --download --json                            # cwd, source file names
genmedia run fal-ai/flux/dev --prompt "a cat" --num_images 3 --download "./out/{index}.{ext}" --json
genmedia status <endpoint_id> <request_id> --download ./out/ --json                        # implies --result
```
Use {index}, {name}, {ext}, {request_id} placeholders in the template when the model returns multiple files (images[], image_urls[], etc.) to avoid filename collisions. A trailing / or an existing directory path saves files under that directory using their source names.

Read the full file on GitHub · 164 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

1mo ago First seen · 164 lines · 72 tokens per session scan A 87549d3978d8

Subscribe to this mod's changes

genmedia is a skill published in the GitHub repository fal-ai-community/genmedia-cli (80 stars, last pushed 2d ago), licensed MIT. It adds 72 tokens to every session and 1,611 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Creative and media agent-skills agents ai cli

wttr-weather

Weather via wttr.in GET (no key). Use for weather/forecast; prefer os.http.request.

AtomicBot-ai/atomic-agent · 25 tokens

jk

Manage Jenkins controllers with jk, including jobs, runs, logs, artifacts, credentials, nodes, queues, and plugins.

avivsinai/jenkins-cli · 26 tokens

ground-state

Before starting any non-trivial implementation, run a pre-flight reconnaissance pass to triangulate git state, project infrastructure, and prior-session memory. Auto-assembles a verified grounding preamble — a session-scoped artifact the orchestrator pastes verbatim into every subsequent sub-agent brief — eliminating…

griffinwork40/agent-afk · 75 tokens

genmedia