抠出透明背景

"透明背景"是自媒体物料里最常见的硬需求：贴纸、Logo、商品小图、可叠加的角色立绘，都要一张能落在任意底色上的 PNG。但内置工具里找不到一个"透明"按钮——这不是疏漏，而是底层模型的限制。本章给你一条不依赖 API Key 的稳定路线：色度键合成（chroma key）。

为什么内置没有"真透明开关"

内置 image_gen 背后的模型是 gpt-image-2，而它不支持 background=transparent 这个参数。真正的"原生透明"——让模型直接吐出带 alpha 通道的图——只有 CLI 回退里的 gpt-image-1.5 能做，而那需要 OPENAI_API_KEY、需要联网、需要花钱。

所以面对绝大多数透明需求，正确的默认动作不是切 CLI，而是换个思路：既然模型不能直接画透明，那就让它在一块"完全平整的纯色幕布"上画主体，事后我们自己把这块幕布抠掉。这正是影视绿幕（chroma key）的逻辑——拍的时候站在绿布前，后期把绿色替换成透明。

默认流程：色度键四步走

把上图拆成可照做的四步。整条流程的"主战场"始终是内置工具，唯一动到命令行的地方是第四步那一行本地脚本——它只是图像后处理，不调用任何远程 API。

1. 在纯色幕布上生成主体

   用内置 image_gen，提示词里明确要求"完全平整的纯色色度键背景"。这一步决定抠图成败——幕布越干净，后面越省事。

2. 选对 key 色

   默认 #00ff00（纯绿）。但若主体本身偏绿，改用 #ff00ff（品红）；若主体偏蓝，避开 #0000ff。原则：key 色绝不能和主体撞色，否则主体会被一起抠掉。

3. 把源图拷进工作区或 tmp

   内置默认存到 $CODEX_HOME/generated_images/…。先 move/copy 到工作区或 tmp/imagegen/，再对它跑脚本——别在默认目录里直接操作。

4. 跑 remove_chroma_key.py 并校验

   脚本输出带 alpha 的 final.png。逐项校验四角透明、无 key 色残边，必要时加 flag 微调（见 第五节）。

写好色度键提示词

抠图脚本再聪明，也救不回一块带阴影、带渐变、有反光的幕布。质量在提示词阶段就锁定了。技能给了五个要点，缺一不可：

• 幕布纯且平——纯 #00ff00、完全平整，专为抠图准备。
• 背景单一均匀——无阴影、无渐变、无纹理、无反射、无地面、无光照变化。
• 主体与背景彻底分离——边缘清晰，四周留足内边距（padding），别贴边。
• 主体内不出现 key 色——主体身上不要有任何 #00ff00 的区域。
• 干净到底——无投影、无接触阴影、无反射、无水印、无文字（除非明确要求）。

运行抠图脚本

幕布图拷进工作区后，对它跑技能自带的本地后处理脚本。它纯靠 pillow 做图像运算，不联网、不要 Key，但需要先 uv pip install pillow。下面这条命令带齐了推荐 flag：

校验清单与边缘微调

脚本跑完别急着交付。逐条过一遍校验清单——任何一条不达标，都意味着要么重生成、要么调 flag 重抠：

• 输出 PNG 确实带 alpha 通道（不是把绿色刷成白色而已）。
• 四角完全透明，没有残留的幕布色块。
• 主体覆盖比例合理，没被误抠掉一部分。
• 主体边缘没有 key 色描边（绿边 / 品红边）。

若发现问题，一次只调一个参数再复检，别一把堆上去。下表列出最常见的边缘瑕疵与对应解法：

何时升级到真·原生透明

色度键能干净利落地处理"边缘明确、不透明、不反光"的主体——图标、贴纸、扁平插画、实心商品。但有一类主体它天生啃不动：

一旦用户拍板要真透明，CLI 路径的关键形态是：用 scripts/image_gen.py 的 generate 子命令、指定 gpt-image-1.5 模型，并带上 --background transparent 与 --output-format png。它会让模型直接输出带 alpha 的 PNG，跳过整套色度键流程。但记住：这是最后一个抽屉，不是默认动作。