用途:本 skill 是通用图像生成执行层,作为被其他 skill 调用的基础设施,不直接由用户触发。调用方 skill 负责 prompt 撰写、样式注入与业务校验,本 skill 只负责接收 prompt、调用 API、返回结果。
主要能力:支持三种生图 API,通过 --provider 切换:mulerun(默认,模型 Nano Banana 2)、apimart(GPT Image 2)、atlascloud(GPT Image 2)。不传 --provider 时自动检测环境变量:仅设 APIMART_API_KEY 用 apimart,仅设 ATLASCLOUD_API_KEY 用 atlascloud,仅设 MULERUN_API_KEY 用 mulerun,多个都设则默认 mulerun。支持 generation(纯文本生图)和 edit(带参考图修图)两种模式,支持单张与批量执行。
使用方式:单张调用示例:python linyuebanzi-image-gen/scripts/generate.py --mode generation --prompt "..." --output-dir ./out。edit 模式需通过 --images 传参考图 URL。批量通过 manifest JSON 提交,可加 --parallel 并行。常用参数包括 --prompt-file、--name-tag、--aspect-ratio(默认 16:9)、--resolution(默认 2K)、--blocklist。输出目录含图片、prompt 文本与元数据 JSON。
适用场景:概念图、流程图、信息图生成,以及需要人物一致性的修图场景。
限制:需设置对应 API Key 环境变量;edit 模式必须传参考图;脚本退出码 0 成功、1 失败;HTTP 403 可能为 Cloudflare WAF 拦截;轮询超时需重试。其余细节暂未提供。