企业官网建设流程全解析

1. 前言：同参数、不同 VAE，图片怎么会发灰

1.1 发灰的现场：固定种子也救不了

Stable-Diffusion WEBUI 里有一种很费解的现场：基础模型没换、种子没换、采样步数没变，只在 VAE 下拉列表里换了一个选项，人物皮肤就从通透变成蒙了一层灰，背景饱和度也明显不对。我最近处理的一组图就是这样，生成的是人物肖像，皮肤像是盖了层薄灰，头发的发丝边缘发糊，背景植物原本的绿色也闷闷的。种子已经固定了，说明初始噪声一样，构图和内容不会变，唯一的变量就是 VAE 的解码结果。排障到最后，问题和模型本身无关，纯粹是 VAE 选错了。这种灰不是后期调色能拉回来的，它发生在图片生成的最后一步，在像素被还原出来之前。

1.2 排障思路：不盲试，先问 Codex

手动对比 VAE 是官方教程里最常推荐的方式，但需要一次次切换、一次次重新生成，再放大看皮肤和背景。因为我同时下载了好几个模型，VAE 文件也攒了一堆，排列组合下去一晚上都不够。所以这次我决定换一种方式：在保持原模型和参数不变的前提下，先打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 创建了 API Key，然后给 Codex 配上 TaoToken 的 Base URL，让它照着 SD WebUI 处理 VAE 的先后顺序帮我缩小范围。Codex 不会直接改 WebUI 的设置，但能帮我把「该选哪个 VAE」这个问题在几分钟内定下来。下面的步骤就按这个顺序来：先搞清楚 VAE 是什么，再判断模型有没有内置 VAE，然后准备好标准 VAE 和 sd_vae 快捷设置，最后用 Codex + TaoToken 完成判断。

2. VAE 是什么：为什么选错图会发灰

2.1 变分自编码器的解码作用

VAE（Variational Auto-Encoder，变分自编码器）虽然名字里带「编码」，但生成图片时用到的是它的解码器部分。Stable Diffusion 先在潜空间里做扩散去噪，得到一个压缩版本的潜在表征，最后一步需要交给 VAE 把它重新还原成像素图。这一步很关键：解码器里的参数决定了颜色空间映射、高频细节保留程度，甚至会影响画面明暗关系。你可以把它理解成给 RAW 照片套预设，同一个底片用不同预设导出，有的鲜艳通透，有的灰蒙蒙。模型本身负责生成内容，VAE 负责把内容「显影」出来，显影配方不对，内容再好也呈现不出来。

2.2 错误 VAE 的典型表现

错误 VAE 最常见的观感是画面发灰、发闷，尤其是高光和暗部过渡处像蒙了一层雾。其次是颜色偏移，比如皮肤偏紫、草地偏黄、天空发青。再就是细节糊，边缘和纹理像是被轻微磨皮过。这三类表现可能同时出现，也可能只出现一种。最迷惑的是：图看起来没有大面积花屏，也没有明显噪声，只是「总觉得哪里不对」，这时候你很容易怀疑模型不好或提示词有问题。原始文章里用了一组同模型、同参数、不同 VAE 的对比图来展示这种差异：错误 VAE 的画面灰得厉害，正确 VAE 的画面立刻通透。遇到这种对比明显的图，基本可以判断当前 VAE 与模型不匹配，下一步就该确认模型有没有内置 VAE。

3. 模型嵌入 VAE 了么：先判断再动手

3.1 看文件名和模型介绍

大部分近期的模型已经内置了 VAE，使用默认的 Auto 设置就可以了。有些模型会在文件名里标注 VAE Baked 或包含 similar VAE included 之类的说明，有些在模型卡片的介绍里写明。如果你下载的模型属于这种，且生成图没有异常，就不用额外选 VAE。但也有一类例外：混合模型（MIX）在融合两个模型时，可能同时带入了两个模型的 VAE 信息，导致内置 VAE 与底模格式冲突。这时候就算文件名写了 Baked，也可能出现发灰或偏色。所以判断模型是否嵌入 VAE，不能只看文件名，还要看生成图有没有异常。

3.2 用模型工具箱插件确认

想确认一个模型文件是否真的嵌入了 VAE，可以在 SD WebUI 里安装模型工具箱插件，加载对应模型后看它的 VAE 字段。如果字段为空，或者提示的版本与你下载的标准 VAE 版本不同，就要手动指定了。这个插件还能直接替换模型内嵌的 VAE，用在 MIX 模型上非常方便：先看看内嵌的是谁，再决定是替换掉还是在外层覆盖一个。做完这一步，你会得到两个明确结论：要么模型自带 VAE 且工作正常，保持 Auto 即可；要么模型没带或带歪了，需要准备标准 VAE，并按照下一章的 sd_vae 快捷设置手动切换。

4. 我们能做什么：准备 VAE 和打开 sd_vae

4.1 准备两个标准 VAE

不管某个模型对应的是哪一款 VAE，两个社区里公认的标准件建议先备好：vae-ft-ema-560000-ema-pruned.safetensors 和 vae-ft-mse-840000-ema-pruned.safetensors。前者是 EMA 版本，画面更柔和；后者是 MSE 版本，细节更锐利。很多模型说明里会直接指定其中一款。把这两个文件放进 SD WebUI 的 models/vae/ 目录，再重启或刷新，就能在 VAE 下拉框里看到它们。

4.2 下载模型对应的 VAE

如果模型页面把模型和 VAE 拆成两个文件下载，请把两个都下下来，只下模型文件会让图片缺少正确的解码器。下载后确认文件名和模型说明一致，比如某个模型指定了 vae-ft-mse-840000-ema-pruned.safetensors，而你手里只有 EMA 版本，可以先试一次。两个标准 VAE 的差异属于风格差异，不会像「没有 VAE / 用错 VAE」那样让画面发灰。把 VAE 和模型放在同一目录也可以，但我更建议统一放 models/vae/，这样不同模型还能共用同一个 VAE 文件。

4.3 快捷设置里打开 sd_vae

SD WebUI 顶部默认只显示基础模型下拉框。要手动切 VAE，需要把它加到快捷设置里：打开【设置 Setting】-【用户界面 User Interface】-【快捷设置列表 Quicksettings list】，在已有 sd_model_checkpoint 的后面追加 sd_vae，保存并重载 UI。注意不要删除前面的 sd_model_checkpoint，否则顶部就没有基础模型选择了。重载之后，顶部会多出一个 VAE 下拉框，默认值是 Auto。Auto 会自动选择模型内置或全局默认的 VAE，但排查发灰问题时，我们需要在 Auto 和一个指定 VAE 之间来回切换。手动对比很直观，但也很费时间：每切一次就要重新生成一遍，再放大看皮肤、看背景、看边缘。

5. 让 Codex 参与排查：TaoToken 给 Codex 配 Base URL

手动对比 VAE 的痛点在于要一版版盲试。如果你同时下载了三四个模型，每个模型对应不同 VAE，排列组合一下，一晚上就过去了。后来我换了个思路：先把模型的文件名、VAE 清单、模型卡说明收集起来，让 Codex 站在 SD WebUI 的 VAE 处理逻辑上先排掉明显不匹配的组合，再回 WEBUI 精准验证。要让 Codex 稳定跑通，我给它接上了 TaoToken。

5.1 去 TaoToken 拿 API Key

Codex 需要走一个能用的模型通道，我用的是 TaoToken。先打开 TaoToken 注册，创建一个 API Key，拿到后保存成 YOUR_API_KEY。TaoToken 是统一的 API 兼容通道，不是绕开模型服务商限制的逆向手段；它只是把不同供应商的接口地址和鉴权方式收拢成一套 Base URL + Key，让 Codex 这类工具不用针对每个供应商单独改配置。Key 的创建、吊销和用量都在官网控制台里完成，可以随时查看。

5.2 修改 ~/.codex/config.toml

Codex 的配置读取 ~/.codex/config.toml。要指向 TaoToken，可以这样写：

model = "<model-id>" model_provider = "taotoken" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "TAOTOKEN_API_KEY" wire_api = "chat"

说明三点。第一，model 的值以 TaoToken 模型广场显示的实际 ID 为准，把 <model-id> 替换成模型广场里的 ID，不要自己编一个。第二，base_url 填 https://taotoken.net/api，结尾不要加 /v1。官网落地页用于注册、建 Key、看模型广场；API 地址专门给工具填，两者不要混。第三，wire_api = "chat" 让 Codex 使用 Chat Completions 协议与 TaoToken 通信，兼容性最稳。

你还需要把 Key 导出到环境变量，Codex 会按 env_key 的名字自动读取：

export TAOTOKEN_API_KEY="YOUR_API_KEY"

YOUR_API_KEY 就是在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 创建的那个 Key。环境变量只在当前终端会话生效，如果换了终端窗口，需要重新 export。想长期生效可以把它写进 shell 的 rc 文件。

5.3 把 VAE 问题变成对话

配置好之后，Codex 就能调用 TaoToken 通道了。接下来把以下信息按清单贴给它：当前模型文件名（如 xxx_mix.safetensors）、你已有的 VAE 文件名列表、模型卡里关于 VAE 的说明（找不到就写「未找到说明」）、出问题图用的采样器、步数、CFG 和负面提示词，因为发灰不一定全是 VAE 的问题。然后问：「按 SD WebUI 处理 VAE 的流程，我应该选哪个 VAE？要不要手动选？如果要，步骤是什么？」

Codex 的回答通常会落在三个方向：如果模型说明里写了指定 VAE，它会直接告诉你用哪一个；如果模型是 MIX 且内置 VAE 有冲突，它会建议你手动指定 MSE 或 EMA 两个标准版之一；如果它判断 VAE 没有问题，会提醒你检查 CFG 和负面提示词。它不会帮你点 WEBUI，但能把选择范围缩到一两项。原本需要四五次对比的活，现在两次以内就能确认。

6. 对比验证与排障：从盲试变成确认

6.1 在 WEBUI 里切换 VAE 做最终确认

Codex 给出建议后，回到顶部 sd_vae 下拉框，保持模型、种子、CFG、提示词全部不变，只切换 VAE。对比时重点看三处：皮肤高光和阴影过渡是否恢复自然；背景色是否回到应有色调；发丝、布料纹理是否更实。如果切换后画面明显通透，说明模型本身没有内置正确 VAE，手动指定的方案成立。如果切换后几乎没变化，说明模型已经内置了 VAE，原来的灰有问题另找原因。

还有一层需要注意：如果你用的是 MIX 模型，即使外层指定了 VAE，模型内部仍可能保留原来的 VAE 信息。Codex 会建议你用模型工具箱插件把内嵌 VAE 替换掉，再配合 sd_vae 做外层指定。这两种方式可以同时存在，方式是先在插件里修改模型，再在 WEBUI 顶部的 VAE 下拉框里选一个与它一致的 VAE。这样以后生成图就不会因为 VAE 冲突反复出问题。

6.2 配置 Codex 时最容易错的三处

第一次给 Codex 配 TaoToken，我碰到过三个报错，你可以直接避开。第一个是 401 Unauthorized，原因是环境变量没导出，或者 YOUR_API_KEY 复制不全。解决方法是重新 export，再去 TaoToken 控制台复制完整的 Key。第二个是 404 Not Found 或 model not found，这个绝大多数是因为 base_url 写成了 https://taotoken.net/api/v1。Codex 自己会在末尾拼接版本路径，不需要我们手动加 /v1。第三个是 Codex 提示 unknown model，原因是 model 字段没有按模型广场的实际 ID 填。一定要去 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 模型广场查看，而不是凭印象写。

7. 收尾：回 TaoToken 看调用记录

7.1 确认 Key 和用量

排查完这一轮，建议回到 TaoToken 控制台看一眼刚才 Codex 的调用是否正常记上账。打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end，你能看到 Key 的创建时间、最近调用次数和用量变化，也能在模型广场确认自己使用中的模型 ID 是否还在服务列表中。以后如果 Codex 出现超时或模型不可用，先来这里查一眼，多半能直接从状态或用量上定位。

7.2 把 AI 当缩小范围的工具

我自己用下来的体会是：VAE 排障最耗时间的不是知识不够，而是要反复生成、反复对比。Codex 接入 TaoToken 后，帮我省掉了中间那些低效排列。它不直接改我的 WebUI 设置，但能帮我判断哪个 VAE 和当前模型是匹配的，sd_vae 下拉框里应该切到哪个选项。最后真正动手的还是我自己，但动手前的判断快多了。下次再遇到生成图发灰，我不会第一时间重新下载模型，而是先问 Codex：这个模型到底有没有内置 VAE，哪个 VAE 匹配度更高？把问题拆给 AI，自己只做验证，是这套流程里最值得保留的习惯。