1. Blender 透明材质发灰的典型场景与排查思路
透明材质在 Blender 里发灰、发白、失去通透感，是很多人在做玻璃杯、水面、薄膜、亚克力板时都会撞上的问题。你明明把 Transmission 拉到 1、Roughness 压到 0，渲染出来却像一块磨砂塑料，甚至整片糊成灰白色。这个现象的本质，通常不是单一参数错了，而是材质节点、混合模式、光线深度、色彩管理四个环节里至少有一个在拖后腿。
先说清楚透明材质到底在做什么。Cycles 里真正的透明靠的是 Transmission（透射），光线穿过表面时按折射率偏折，玻璃的 IOR 约 1.45，水约 1.33，钻石 2.42。Eevee 里则依赖 Blend Mode 和屏幕空间折射，机制完全不同。很多人把两种引擎的参数混着用，结果就是 Cycles 里发灰、Eevee 里发白。
适合读这篇的人有三类：刚接触 Blender 想做出干净玻璃质感的新手；已经会搭节点但渲染结果总差一口气的中级用户；以及想把渲染任务放到统一 API 通道上做批量对比、需要稳定复现结果的开发者。我试过在同一个场景里反复切换引擎和参数，最后发现大部分“发灰”根本不是材质问题，而是光线反弹次数不够或者色彩管理把高光压死了。
排查顺序建议这样走：先确认引擎和材质节点是否匹配，再看混合模式与折射设置，接着检查光线深度，最后核对色彩管理与输出色彩空间。每一步都能单独定位一类问题。下面会给出可直接复制的节点参数、引擎设置清单，以及用 TaoToken 统一 Key 通道提交渲染任务、对比结果的验证步骤，帮你判断问题到底出在材质还是渲染链路。
需要提前说明的是，透明材质的“通透感”很大程度取决于背景和光照。一个纯灰背景下的玻璃，无论参数多正确，看起来都不会通透，因为它没有可折射的环境细节。所以排查时一定要用有明暗对比的 HDRI 或实景背景，否则你会一直在错误的方向上调参数。
2. TaoToken 前置准备：统一 Key 与 API 通道
在深入材质参数之前，先解决一个容易被忽略的链路问题：渲染任务的提交和结果对比。如果你只是本地单机渲染，可以跳过这章直接看第 3 章。但如果你需要批量跑不同参数组合、对比透明材质在不同设置下的差异，手动一个个改参数再渲染会非常低效。这时候用统一的 API 通道来管理任务提交和结果回收，能省下大量重复劳动。
TaoToken 在这里的角色是一个统一的模型与任务调用入口。它的官网是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 端点是 https://taotoken.net/api 。你需要先在控制台创建一个 API Key，然后就可以用同一个 Key 调用不同的能力，包括模型对话、编码计划等。对于渲染对比场景，你可以把参数组合和预期结果写成结构化请求，通过 API 批量提交，避免手动操作带来的误差。
具体操作路径是这样的：打开控制台 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，登录后进入 API Keys 页面 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite ，新建一个 Key 并复制保存。这个 Key 就是你后续所有请求的凭证。注意不要把它硬编码到公开的脚本里，建议用环境变量管理。
如果你用的是 Claude Code 或类似的编码工具来做渲染脚本，可以参考接入文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 里的配置说明。文档里会给出 Base URL、Key 和 Model ID 三件套的填写方式，这三者在任何接入场景里都是必须对齐的。Base URL 填 https://taotoken.net/api ，Key 填你刚创建的那串字符，Model ID 根据你实际调用的能力选择。
对于长期做渲染任务或 Agent 编排的场景，可以考虑 Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ，它更适合需要持续调用、批量处理的 workflow。而如果只是想先验证某个模型对渲染参数的理解，可以直接用模型对话 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=chat&utm_campaign=rewrite 快速试一下。
前置准备的核心就三件事：拿到 Key、确认 Base URL、选对 Model ID。这三件套对齐了，后面的验证请求才能跑通。很多人卡在 401 就是因为 Key 没填对或者 Base URL 写成了别的地址。下一章会给出完整的可复制配置片段。
3. 可复制配置：材质节点、引擎设置与 API 请求片段
这一章是全文的核心操作部分。我会把 Cycles 和 Eevee 两套配置分开写，你可以直接复制到自己的工程里对照。同时给出用 TaoToken 提交渲染对比任务的 JSON 片段，路径和字段名都按实际接口来。
先看 Cycles 的玻璃材质节点配置。新建材质后，删除默认的 Principled BSDF 之外的节点，只保留一个 Principled BSDF 连接到 Material Output。关键参数如下：
Base Color: (1.0, 1.0, 1.0) 纯白 Metallic: 0.0 Roughness: 0.0 到 0.05 之间 IOR: 1.45（玻璃）或 1.33（水） Transmission: 1.0 Transmission Roughness: 0.0 Alpha: 1.0这里最容易出错的是 Transmission 和 Alpha 混用。在 Cycles 里，Transmission 才是真正的透射，Alpha 是透明度遮罩，两者语义不同。如果你把 Alpha 调到 0.5 又开了 Transmission，结果会发灰。正确做法是只用 Transmission，Alpha 保持 1.0。
Eevee 的配置完全不同。Eevee 不支持真正的光线透射，它靠 Blend Mode 和 Screen Space Refraction 模拟。设置清单如下：
Material Settings: Blend Mode: Alpha Blend 或 Alpha Hashed Shadow Mode: Alpha Hashed Screen Space Refraction: 勾选 Refraction Depth: 0.0 到 0.1 Principled BSDF: Transmission: 1.0 Roughness: 0.0 IOR: 1.45 Alpha: 1.0注意 Eevee 的 Screen Space Refraction 需要在 Render Properties 里也开启，否则材质面板勾了也没用。另外 Eevee 的折射只对屏幕内可见的部分生效，背景如果太单调，折射效果会很不明显，看起来就像发白。
光线深度是另一个高频坑点。Cycles 默认的 Light Paths 设置里，Transmission 反弹次数可能只有 8 或 12，做多层玻璃或水面时不够用。建议改成：
Render Properties > Light Paths > Max Bounces: Total: 32 Transmission: 16 Transparent: 16 Glossy: 8色彩管理方面，View Transform 建议用 Filmic 或 AgX，Standard 容易让高光溢出导致发白。Look 保持 None，Exposure 和 Gamma 默认即可。输出色彩空间用 sRGB。
现在给出用 TaoToken 提交渲染对比任务的 JSON 片段。假设你要对比两组参数下的透明材质表现，可以这样构造请求：
{ "model": "your-model-id", "messages": [ { "role": "user", "content": "对比以下两组 Blender Cycles 透明材质参数在玻璃杯场景下的渲染差异：A组 Transmission=1.0, Roughness=0.0, IOR=1.45, Max Transmission Bounces=16；B组 Transmission=1.0, Roughness=0.1, IOR=1.45, Max Transmission Bounces=8。请分析哪组更通透，并说明原因。" } ], "base_url": "https://taotoken.net/api", "api_key": "YOUR_API_KEY" }这个片段里的 base_url 和 api_key 就是第 2 章说的三件套里的两件，Model ID 按你实际选的填。提交后你会得到模型对两组参数的分析，帮你快速判断哪组更接近预期，而不需要真的渲染两遍再肉眼对比。
如果你用 Claude Code 做自动化脚本，配置可以写成 TOML 或 settings 片段：
[taotoken] base_url = "https://taotoken.net/api" api_key = "YOUR_API_KEY" model_id = "your-model-id"路径和字段名保持和文档一致，不要自己改。改错了就会报 local proxy failed 或 401。
4. 验证请求与成功结果：确认链路是否跑通
配置写完之后，必须验证链路是否真的通了。这一步很多人跳过，结果后面出问题时分不清是材质参数错了还是 API 没连上。验证分两层：先验证 API 通道，再验证渲染结果对比。
先验证 API 通道。用 curl 发一个最简单的请求：
curl -X POST https://taotoken.net/api/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_API_KEY" \ -d '{ "model": "your-model-id", "messages": [{"role": "user", "content": "回复 OK"}] }'如果返回里包含 choices 字段和正常的 message 内容，说明通道通了。如果返回 401，说明 Key 不对或没带上 Authorization 头。如果返回 local proxy failed，说明 Base URL 写错了或者网络层有问题。如果报 reading choices 相关错误，通常是响应格式和预期不符，检查 Model ID 是否填对。
通道通了之后，再验证渲染对比。把第 3 章的 JSON 片段实际提交一次，观察返回的分析结果是否合理。成功的结果应该能明确指出两组参数在通透感上的差异，并给出可操作的调整建议。如果返回内容泛泛而谈，说明你的 prompt 不够具体，把场景、参数、预期都写清楚。
本地渲染这边，验证方法是固定一个玻璃杯场景，分别用 A 组和 B 组参数渲染，输出 PNG 后用图像工具对比直方图。通透的玻璃在直方图上高光和暗部都有分布，发灰的玻璃则集中在中间调。你可以用这个客观指标辅助判断，而不是只靠肉眼。
实测下来，大部分“发灰”问题在通道验证阶段就能排除掉链路因素。如果 API 返回正常但渲染还是灰，那问题一定在材质或引擎设置里。反过来，如果 API 都连不上，先别急着调材质，把三件套对齐再说。
验证通过的标准有三个：API 返回包含有效 choices；渲染对比分析能给出具体参数建议；本地渲染的直方图显示高光暗部都有分布。三个都满足，说明你的链路和材质配置都是对的。
5. 本篇常见错误排查：401、local proxy failed、reading choices、OAuth
这一章对照真实报错来排查。透明材质发灰本身不报错，但你在用 API 做对比验证时会遇到各种错误，分不清就会误以为是材质问题。下面逐个拆解。
401 Unauthorized 是最常见的。原因通常是 API Key 没填、填错、或者 Authorization 头格式不对。正确格式是Bearer YOUR_API_KEY，Bearer 和 Key 之间有一个空格。如果你把 Key 直接放在 URL 参数里，也会 401。检查控制台里 Key 是否被删除或过期，重新生成一个再试。
local proxy failed 通常出现在 Base URL 配置错误时。比如你把 Base URL 写成了带路径的完整端点，或者写成了别的地址。正确做法是 Base URL 只填 https://taotoken.net/api ，具体路径由 SDK 或请求自己拼接。如果你在 Claude Code 的 settings 里把 base_url 写成了 chat 页面的地址，就会报这个错。
reading choices 相关错误，一般是响应结构和你代码里解析的字段不匹配。比如你按 OpenAI 格式解析 choices[0].message.content，但实际返回结构不同。解决方法是先打印完整响应体，看清楚字段层级再改解析逻辑。Model ID 填错也会导致返回结构异常，确认你用的 Model ID 在文档里有列出。
OAuth 相关报错，通常出现在 Claude Code 或类似工具的登录环节。如果你用的是 API Key 模式，就不应该走 OAuth 流程。检查配置文件里是否同时存在 OAuth token 和 API Key，两者冲突时会报错。把 OAuth 相关字段清掉，只用 Key 认证。
还有一个隐蔽的坑：透明材质在 Cycles 里发灰，有时候是因为 Film 设置里的 Transparent 没勾，或者 Film > Filter 设成了 Box 而不是 Gaussian。这些设置不影响 API，但会让渲染结果偏灰。排查时把 Render Properties > Film 里的 Transparent Glass 勾上，Filter 用默认 Gaussian，Size 1.5。
Eevee 这边，如果 Blend Mode 设成了 Opaque，透明材质会直接变成不透明，看起来就是一块灰白板。确认 Blend Mode 是 Alpha Blend 或 Alpha Hashed，并且 Shadow Mode 也跟着改。Screen Space Refraction 没开的话，玻璃会失去折射，看起来像塑料。
最后提醒一点：如果你在材质里同时用了 Transparent BSDF 和 Principled BSDF 混合，混合系数没调好也会发灰。建议新手直接用 Principled BSDF 的 Transmission，不要手动混 Transparent BSDF，除非你明确知道自己在做什么。
6. 把渲染对比流程固定下来：从材质到链路的闭环
排查透明材质发灰，最有效的方式不是反复试参数，而是把变量控制住。材质节点、混合模式、光线深度、色彩管理这四个维度，每次只改一个，其他保持不变，用 API 通道批量提交对比，记录每次的结果。这样你才能确定到底是哪个参数在起作用。
具体做法是建一个基准场景，玻璃杯加 HDRI 背景，固定相机和光照。然后写一个参数矩阵，比如 Transmission 取 0.8/1.0，Roughness 取 0.0/0.05/0.1，IOR 取 1.33/1.45/1.52，组合成若干组。每组通过 TaoToken 提交一次分析请求，同时本地渲染一张图。把 API 返回的建议和实际渲染结果对照，几轮下来你就能摸清自己场景里最敏感的参数是哪个。
这个流程的价值在于可复现。下次再遇到发灰，你不用从头猜，直接跑一遍矩阵就能定位。而且因为 API 通道是统一的，换机器、换项目都不用重新配环境，Key 和 Base URL 三件套对齐就行。
对于需要长期做渲染任务的人，建议把参数矩阵和提交脚本固化下来，配合 Coding Plan 做持续调用。这样每次调整材质，都能快速得到对比结果，而不是靠感觉调一晚上。透明材质的通透感最终取决于你对光线行为的理解，工具只是帮你更快逼近那个正确答案。
