用途：genmedia 是 fal.ai 的 agent-first CLI，用于搜索模型、运行推理、上传文件、查询定价和检索文档，便于智能体以结构化方式调用 fal.ai。
认证：按优先级读取 FAL_KEY 环境变量、~/.genmedia/config.json（由 genmedia setup 写入）、项目 .env 文件（若启用自动加载）。
主要命令：models 支持自由文本搜索 600+ 模型，可用 --category、--status、--limit、--cursor、--endpoint_id、--expand openapi-3.0 等参数；schema 查看模型输入输出，--format openapi 返回完整 OpenAPI 规范，运行前应先执行；run 执行模型，任意输入参数以 --flag value 传入，默认等待结果，--async 用于视频等长任务并返回 request_id；status 查询或获取异步任务，支持 --result、--logs、--cancel、--download；upload 上传本地文件或远程 URL 到 fal.ai CDN，返回可用作输入的 URL；pricing 查询模型费用；docs 搜索 fal.ai 文档。
下载输出：用 --download 让 CLI 提取、抓取、命名并并发保存结果中的媒体 URL，路径写入 downloaded_files[]；失败项列入 download_failures[]。无值保存到当前目录，目录路径保存到该目录，模板支持 {index}、{name}、{ext}、{request_id}。status 上的 --download 隐含 --result，不能与 --cancel 同用。
错误处理：命令失败时以非零退出并向 stderr 写 JSON 错误对象，含 error、details（status、error_type、validation_errors、body、logs、request_id）。422 应读取 validation_errors 修正参数后重试；401/403 检查凭据；404 核对 endpoint_id；429 或 5xx 可短暂退避重试。
限制：资料未提供安装方式、平台支持、收费与价格细节，暂未提供。