SuperAPI AI 工具集

native-transparent-imagegen

设计与创作

查看项目

更新于 10-16 06:02

技能介绍

用途

Native Transparent ImageGen 用于一个边界明确的场景:生成全新的位图素材,且交付物必须包含原生像素透明(native alpha)。它只处理“新生成且需要原生透明”的资产,不处理从已有不透明图片中移除背景的需求。

主要能力与原则

  • 以原生 alpha 生成素材。可见的棋盘格、提示词中写了“transparent”、以及工具调用成功,在原始文件通过 alpha 检查之前都视为未验证。
  • 保持边界严格:仅用于新生成且交付物必须含原生透明的资产;除非用户明确要求编辑,否则提供的图片只作为身份、主体、构图或媒介参考。
  • 不得调用去背、分割、色键提取、蒙版或本地 alpha 合成来挽救不透明输出。
  • 不得把渲染出来的棋盘格称为“透明”。RGB 棋盘格即为失败资产。
  • 如果用户实际想要的是从已有不透明图片中移除背景,应转到背景提取工作流,并说明那是编辑而非原生生成。

使用方式

生成时保守处理:保留用户的主体、身份、风格、构图与文字约束,并附加一条简洁的输出要求——返回主体之外区域为真实像素透明、带真实 alpha 通道的 PNG 或 WebP。

对于仅支持提示词的内置图像工具,原生 alpha 交付物应逐个生成,不要并行,除非当前工具暴露了明确的按请求背景控制且并发原生 alpha 行为已被验证。

当用户明确选择暴露输出控制的 API 路径时,请求 background: "transparent" 与 output_format: "png" 或 "webp"。

保留原始返回字节。校验不得重写、优化、合成、缩放或以其他方式改动交付物。

在准备提示词、重试失败输出、生成多个资产或报告限制时,阅读 references/prompting-and-retry.md。

校验未改动的文件

仅在缺少依赖时安装校验器依赖:

python3 -m pip install -r
"${CODEX_HOME:-$HOME/.codex}/skills/native-transparent-imagegen/scripts/requirements.txt"

对每个请求的交付物运行只读校验器:

python3
"${CODEX_HOME:-$HOME/.codex}/skills/native-transparent-imagegen/scripts/validate_alpha.py"
--require-transparent-corners
/path/to/original-output.png

文件通过技术门槛的条件是:解码像素包含 alpha 通道;至少一个像素完全透明且至少一个像素可见;当资产需要被隔离时,要求的留白边角为透明;且校验器在原始输出上成功退出。

随后在对比查看器背景上检查实际边缘。alpha 元数据无法证明细毛干净或图像没有大范围半透明雾。即使元数据门槛通过,也要拒绝可见棋盘格、遮罩光晕、彩色雾、意外阴影、被裁断的发丝或缺失细节。

重试而不伪造成功

遇到 RGB 或不透明输出时,保留所有主体不变量,只重试原生 alpha 输出指令。

每个不同资产最多进行三次生成尝试,除非用户要求更多。

每次尝试后都校验。不要把失败图像编辑成合规。

如果所有尝试都失败,停止并报告原始模式与校验失败原因。仅在可用且获授权时提供明确的 API 路线;绝不静默更换模型或使用背景提取。

报告证据

对每个被接受的资产,报告:生成路线与已知模型;原始文件路径、格式、尺寸、模式与 SHA-256;alpha 极值、完全透明像素数、边角 alpha 值与校验器结论;目视边缘 QA 结果;以及最终提示词原文或添加到用户提示词中的原生 alpha 条款。

将已生成、alpha 已验证、边缘已检查、用户已接受与已发布保持为彼此独立的状态。

适用场景与限制

适用于需要原生透明的新生成位图素材(如透明贴纸等)。不适用于从已有不透明图片中移除背景;此类需求应转到背景提取工作流并说明其为编辑。资料未提供具体支持的模型清单、收费方式、价格或平台范围。