Image API 工作台
目的
针对 OpenAI 或经过审查的兼容网关，运行可重复的图像 API 生成或编辑操作。CLI 会验证请求、编录流式部分结果、输出文件和证据。默认使用 gpt-image-2；编录仅作为路由证据，而非端点证明。
工作流程
- 在更改模型或高级参数前，请阅读 模型支持。
- 对每种新的参数组合，先使用
scripts/image_api_workbench.py --dry-run。 - 使用
--list-remote-models检查已配置的网关，无需消耗图像配额。 - 使用
/v1/images/generations生成图像；添加--input-image可切换到/v1/images/edits。 - 如需透明度通道，使用
--background transparent --output-format png或webp。 - 仅当网关支持图像 SSE 中继时，使用
--stream --partial-images 1..3。 - 将生成的资源保存到本技能目录之外，并检查图像及其元数据侧边文件。
安全默认值
gpt-image-1.5、gpt-image-1-mini和chatgpt-image-latest需要--allow-deprecated-model；这些模型计划于 2026-12-01 关闭。- 已废弃的 DALL-E 模型被阻止使用，除非显式使用
--allow-retired-model。 - 已知的 GPT 图像参数会进行模型验证。提供者扩展需要
--allow-provider-extensions。 - 凭证来自环境变量或令牌文件。切勿将密钥持久化存储在提示词、元数据、技能文件、报告或日志中。
- 默认情况下，元数据会存储提示词的哈希值。提示词预览是可选的。
编辑与本地化
对于需要匹配双语视觉效果的场景，请创建一个经批准的母版图像，然后针对每种语言编辑该图像。保留构图和非文本细节；仅替换可见的文字内容。使用 scripts/bilingual_contact_sheet.py 构建并排对照审查。
有关命令、错误分类、流式行为和验证的详细信息，请参阅 操作指南。
路由边界由 evals/trigger_cases.json 覆盖。
输出合约
一次成功的付费调用必须满足：
- stdout JSON 中包含
ok: true； - 最终图像存在且非空；
- 元数据侧边文件存在（除非显式禁用）；
- 检测到的格式和尺寸合理；
actual_size_matches_request被检查而非推断；- 编辑元数据中每个输入文件均按路径、字节数、SHA-256 和尺寸进行标识。
编录和空转并不能证明端点支持。付费探针需要用户批准。