用途：genmedia CLI 用于端到端执行 fal.ai 模型，可按任务描述（如“生成一只狗奔跑的视频”）或指定 endpoint_id（如 fal-ai/flux/dev）运行，覆盖图像、视频、音频的生成、转换、放大与风格化。
主要能力：模型发现与检索（genmedia models "<task>" --json）；查看模型输入参数（genmedia schema <endpoint_id> --json）；上传本地文件或 URL 作为输入（genmedia upload <local_file_or_url> --json）；运行模型并支持同步或异步模式；查询异步任务状态；通过 --download 将结果中的媒体 URL 写入本地文件系统并返回 downloaded_files[] 路径，支持 {index}、{name}、{ext}、{request_id} 占位符避免重名。
Assets 库：fal Assets API 可持久化生成媒体、组织到集合、定义可复用角色。资产可用 vector_id（来自 assets browse/get/upload 或语义搜索结果）或 request_id（来自 genmedia run/status）标识；assets upload 仅用于本地文件或非 fal URL。
使用方式：先搜索或指定模型，读取 schema 确认必填字段，必要时上传素材，再运行；慢任务用 --async 后配合 status --result 查询。建议始终加 --json 以获得机器可读输出；关注成本可先运行 genmedia pricing <endpoint_id> --json；不确定模型时可用 genmedia docs "<task>" --json。
限制：错误以 JSON 输出到 stderr，422/ValidationError 表示输入违反模型 schema，需按 validation_errors 修正后重试；401、403、404、429、5xx 直接返回服务端消息，不应盲目重试 4xx。新引用的媒体可能需等待嵌入完成才出现在浏览或语义搜索中。具体模型、价格与平台支持范围以 fal.ai 官方为准，资料未提供完整清单。