用途:在人物、概念或镜头输入已就绪后,执行托管图像生成或基于参考图的编辑,并支持批量生成独立变体。输出需包含本地图像文件,以及可长期保存的请求、响应和清单记录,便于后续质检或视频渲染。
主要能力:通过公开的 postplus media create 命令执行托管图像生成与编辑,任务为异步。提交后记录运行句柄、当前状态和已完成工件元数据(字节不会自动下载)。基于参考图的编辑通过重复的 --reference-image 传入每张源图,值可为本地路径、HTTPS URL、既有 PostPlus 媒体引用或 data URI;CLI 会校验并准备本地媒体后再单次提交,无需预先上传或手工构造请求。可用 image-gpt-image-2-edit 默认编辑端点;文本端点 image-gpt-image-2-text 不接受 --reference-image,会报 Unknown option,因此参考图生成必须走编辑端点。
使用方式:先运行就绪诊断 postplus doctor --skill image-batch-runner。生成示例命令为 postplus media create image-gpt-image-2-text --prompt "Describe the result you need" --wait --output ./result.json。轮询待处理任务:postplus media poll --handle <output.data.id> --output path/to/generation-result.json,复用初次提交的结果路径,使完成后的轮询原子替换处理中的 JSON。下载成品:postplus media-file download --reference <output.data.artifacts[0].mediaReference> --output-file <path>。仅在需要完整端点、标志与枚举契约或修复未知请求形状时使用 postplus media schema --json。
批量规则:批量分发独立项目前,先单独提交第 1 项并轮询至终态作为金丝雀;若被内容策略拦截(类型化代码 postplus_cli_hosted_media_content_policy_blocked),记录并跳过,再对下一项做金丝雀,仅在非拦截金丝雀成功后才批量分发。其他金丝雀失败视为系统性,应停止。批量隔离:逐项内容/安全拒绝仅隔离该项,记录原因后跳过,继续提交与轮询其余项,最后报告不完整集合;不得重试或改写被拦截项。其他失败(认证、传输、配额、请求格式错误、服务中断)均为系统性,应停止。
适用场景:人物锁、概念或镜头需求已明确,且下一步就是托管生成或参考图编辑;需要本地图像文件与持久清单记录以便质检或视频渲染时。
限制:不得用于创意构思、质检或其他已发布技能;缺少必需输入且猜测会改变结果时不用;创意分类、模型/参考策略或分镜逻辑未决时先用 image-generation 技能。此运行器只校验并执行已解析请求,不得做创意策略、任务分类或参考策略决策。除用户或上游简报指定特定模型族、比例、质量或分辨率外,应优先使用默认高质量模型。标识符与运行本地状态(assetId、runId、localAssetDir、清单路径)由运行器生成或派生,不要自行提供,应从结果中读取以便交接。需等待用户明确批准时再执行;某项操作不授权花费、发布或覆盖。遇到引用确认挑战时,须先取得用户对范围与成本批准,再运行 postplus quote confirm --json --challenge-file <challenge.json>,并用返回令牌重试。部分失败仅在轮询时可见,提交通过的批次仍可能全部失败。