用途：gen-ai 批量技能用于一次运行多个生成任务，并将生成结果接入脚本、定时任务或 CI/CD 流水线。适合需要一次生成超过 5 个素材、从清单/CSV 转出的 JSON/目录批量生成、按目录或表格逐行产出素材、以及编排自动化内容管线的场景。
主要能力：CLI 批量走 gen-ai batch run <manifest.json>；失败任务用 gen-ai batch resume <output-dir> 重试。清单为带 jobs 数组的对象，defaults 会合并进每个 job 的生成上下文，job 自身字段可覆盖默认值。常用按 job 字段包括 id（必填唯一）、model、prompt、negativePrompt、aspectRatio、count、imageUrls、videoUrl、audioUrl、duration、voiceId 等，具体模型字段需先用 gen-ai models info <model-id> 与 gen-ai validate -m <model-id> --file payload.json 校验。目录模式用 gen-ai generate --input-dir ./raw -m recraft-replace-bg -p "..." --batch --concurrency 4 --download ./styled，会先做预检并转为内部清单。
使用方式与输出：gen-ai batch run manifest.json -c 4 -o ./batch-output，支持 --dry-run、--no-download、--download-concurrency、--json、--quiet、--no-input。批量运行总会在输出目录写入 results.json，可用 jq '.jobs[] | {id, status, url}' 提取状态与地址。单次生成可用 --json --no-input 得到干净标准输出并配合 jq 与 curl 保存指定文件名，也支持从 stdin 读入提示词。CI/CD 示例包括 GitHub Actions 在合并时重新生成 OG 图、Next.js 的 prebuild 钩子生成主视觉、以及 cron 定时批量任务。
限制与成本：CLI 目前没有批量估价命令，需用 gen-ai pricing <model>（如 gen-ai pricing kling-v3-pro --duration 5）估算并按任务数或时长相乘，运行前可用 --dry-run 校验清单。没有策略门控参数，存在 brand.md 时应将其约束并入每个提示词或提示词文件。manifest 必须用 jobs 而非 items，且不应依赖按 job 输出路径、tags、重试参数或批量估价参数。MCP 宿主提供等价的生成与批量能力，但示例仍应遵循 CLI 约定。常见问题包括清单缺 jobs、任务缺 model（job.model 或 defaults.model）、未知模型、限流（降低 --concurrency 后 resume）及供应商错误（查看 results.json 后 resume）。