AI驱动Blender建模：从自然语言到3D场景的自动化实践

在实际 3D 场景制作流程里最耗时的往往不是创意而是把创意翻译成 Blender 操作。重复建模、调材质、摆灯光、设相机这些步骤会占掉大量时间。如果能把自然语言需求交给 DeepSeek 做场景拆解再让 Codex 这类终端编程 Agent 按照固定 skill 生成并执行 Blender Python 脚本整个建模过程就可以变成一条可复用的自动化链路。下面以“天宫仙境”风格的悬浮宫殿场景为例说明从环境准备、skill 设计、脚本生成到渲染验证的完整过程。这篇文章不会停留在“AI 很厉害”这种层面而是会给出可以直接落地的目录结构、配置文件、Python 脚本、运行命令和排错路径。你不需要一次学会所有 Blender API只需要理解这套“自然语言 - 结构化方案 - Blender 脚本 - 渲染验证”的协作方式然后把它套用到自己的场景上。1. 先看清 DeepSeek、Codex 与 Blender 之间的分工1.1 为什么直接写 Blender 脚本不够Blender 本身提供了完整的 Python API核心模块叫bpy。通过bpy几乎所有的建模、材质、灯光、相机、渲染设置都能用代码完成。一个最简单的例子是import bpy bpy.ops.mesh.primitive_cube_add(size2, location(0, 0, 1))这段代码会在世界坐标(0, 0, 1)处创建一个边长为 2 的立方体。把这类操作组合起来就能生成复杂的场景。但直接写脚本有两个明显问题。第一个问题是脚本太死板。你写了一个“宫殿生成脚本”它可能只能生成固定数量、固定位置的柱子。一旦需求变成“把宫殿抬高一点”“屋顶改金色”或“增加 12 根柱子”你就要改代码甚至改好几处参数。第二个问题是模型生成的脚本不一定可靠。直接让大模型写一段长脚本它可能给你生成一个看起来合理但无法运行的脚本。原因通常是使用了不存在的bpy.ops参数、忘记设置渲染路径、在系统 Python 里直接import bpy、或者依赖了当前选中的对象但没有提前选中。所以真正要解决的并不是“能不能用 AI 生成代码”而是“如何让 AI 生成代码时遵守足够多的工程约束”。这正是 skill 的作用。1.2 DeepSeek 负责“想”Codex 负责“做”在这条链路里DeepSeek 和 Codex 不是两个独立运行的程序而是同一个 Agent 工作流中的不同角色。你可以把 Codex 理解为终端里的编程代理它负责读取任务、生成代码、执行命令、看到报错后继续修改。而 DeepSeek 是 Codex 背后的模型提供方负责理解用户需求、把需求拆成步骤、写出可以运行的 Blender Python 脚本并在执行失败时根据错误信息修正代码。整体流程可以表示成下面这条路径用户自然语言需求 - DeepSeek 进行场景拆解和脚本规划 - Codex 生成 Blender Python 脚本 - Codex 调用 blender -b -P 执行脚本 - 根据日志和报错修正脚本 - 最终输出 .blend 文件和渲染图片为什么需要这种分工因为“天宫仙境”这种需求太模糊。直接让 AI 写一行bpy.ops.mesh.primitive_cube_add不难难的是把这个需求拆成“浮岛、宫殿、柱廊、云海、主光、补光、相机、渲染参数”这些可执行模块。DeepSeek 这类 LLM 很擅长做这种拆解。它能理解“东方奇幻风格”“傍晚光线”“悬浮宫殿”这些语义然后输出一套结构化的建模方案。Codex 则负责把这些方案变成真实的文件、真实的命令并在当前电脑环境里跑起来。1.3 skill 的作用把“经验”变成“约束”如果你用过 Agent肯定遇到过这种场景同一个问题换一种问法输出质量就完全不同。原因是 Agent 没有稳定的“工作方法”。skill 本质上是一组结构化材料它告诉模型当前任务属于什么领域。应该遵守哪些约束。推荐使用哪些函数和写法。执行完成后需要检查哪些事情。对 Blender 建模来说skill 里可以写清楚单位使用米、物体名必须语义化、材质使用 Principled BSDF、脚本入口放在if __name__ __main__、禁止在系统 Python 里导入bpy、渲染前必须确认相机和灯光对象存在。有了这些约束Codex 生成脚本时就不是“从零发挥”而是“在一个专业建模助手的经验框架里发挥”。这也是 skill 与普通提示词最大的区别普通提示词是临时的skill 是可复用、可版本管理、可跨项目复制的。2. 环境准备从 Blender 到 Codex CLI 与 DeepSeek 模型2.1 确认 Blender 环境和 Python API先安装 Blender。建议使用 Blender 3.6 LTS 或 4.x 版本。安装完成后在终端确认命令可用blender --version如果blender不是系统命令你需要把 Blender 的可执行文件路径加入PATH或者在后面的命令里使用完整路径。例如 macOS 上常见路径是export BLENDER_PATH/Applications/Blender.app/Contents/MacOS/Blender接着验证 Blender 自带的 Python 环境能否正确导入bpyblender -b --python-expr import bpy; print(bpy.app.version_string)这里的关键点在于-b它表示 background mode也就是不启动图形界面。Blender 在后台模式下可以执行 Python 脚本并直接输出日志到终端。这是自动化控制 Blender 的基础。执行后如果看到类似4.1.0的版本号说明环境正常。注意不要用系统 Python 安装bpy包也不要尝试在普通的python script.py里导入bpy。bpy只有在 Blender 自带的 Python 运行时里才可用。这也是后面最常见的报错来源。2.2 安装 Codex CLI 并确认可执行文件位置Codex CLI 是终端里的编程 Agent。常见安装方式是通过 npm 全局安装具体以官方文档为准npm install -g openai/codex codex --version安装完成后确认codex能被执行which codex这里要注意一个高频问题搜索结果里经常看到unable to locate the codex cli binary这类报错。它通常意味着某个 IDE 插件或工具在调用 Codex 时找不到codex可执行文件。解决方式是手动指定路径export CODEX_CLI_PATH$(which codex)如果你使用的是 Windows可以把该环境变量写入系统环境变量或者在 IDE 的设置面板里指定codex二进制路径。2.3 配置 DeepSeek 作为 Codex 的模型后端Codex CLI 默认使用官方模型。要接入 DeepSeek需要在配置文件中指定模型提供商。下面是一份常见参考配置字段名和写法以你当前 Codex 版本文档为准# ~/.codex/config.toml model deepseek-chat model_provider deepseek [model_providers.deepseek] name DeepSeek base_url https://api.deepseek.com/v1 env_key DEEPSEEK_API_KEY wire_api chat然后设置环境变量export DEEPSEEK_API_KEY你的密钥DeepSeek API 提供 OpenAI 兼容接口deepseek-chat和deepseek-reasoner是常见模型名称具体以 DeepSeek 官方文档为准。配置完成后可以先用一个简单任务验证 Codex 能正常调用模型codex exec 请回复okcodex exec是否可用取决于版本。如果不支持非交互模式也可以直接进入 Codex 交互终端输入一句简短任务来测试。2.4 建立统一工作目录自动化建模过程中会产生脚本、临时.blend文件、最终.blend文件、渲染图片、日志等多个文件。建议先建立固定目录避免 Agent 把文件散落得到处都是heaven_palace/ assets/ # 存放 .blend 文件、贴图、参考图 scripts/ # 存放 Codex 生成的 Python 脚本 output/ # 存放渲染结果 skills/ # 本地 skill 备份 logs/ # 脚本执行日志这个目录结构看起来简单但它能解决一个很实际的问题Codex 生成的脚本经常把输出文件写到//render/xxx.png这种相对路径而相对路径到底相对于哪个目录取决于当前激活的.blend文件。固定工作目录后可以把路径写成绝对路径或者统一约定//的含义。3. 为 Codex 设计一套可复用的 Blender 建模 skill3.1 skill 应该包含什么在设计 skill 时不要把它写成长篇大论的论文。一个 skill 应有的核心内容是任务目标。适用环境。必须遵守的约束。推荐的代码结构。完成后的检查清单。对 Blender 建模场景来说最重要的约束是所有脚本必须由 Blender 自带 Python 执行不能依赖系统 Python物体命名要有语义材质要使用节点输出路径要明确。3.2 创建一个 blender-modeling skill在用户目录下创建一个 skill 目录。如果你的 Codex 版本支持自动发现 skill通常可以放在~/.codex/skills下。如果不支持也可以把SKILL.md里的内容复制到项目根目录的AGENTS.md或者作为系统提示词的一部分。~/.codex/skills/blender-modeling/ SKILL.md checklist.md templates/ scene_builder.py examples/ create_material.py render_settings.pySKILL.md是核心文件内容可以这样设计# Blender Modeling Skill ## 目标 根据用户需求生成可执行的 Blender Python 脚本并在 Blender 命令行环境下运行验证。 ## 环境 - 使用 Blender 自带的 Python 运行脚本。 - 禁止在系统 Python 中导入 bpy。 - 模型单位使用 Metric 和 Meters。 - 脚本入口统一放在 if __name__ __main__ 中。 ## 建模约束 - 创建对象后必须设置语义化名称例如 FloatingIsland、PalaceHall、Cloud_001。 - 材质使用 Principled BSDF 节点。 - 不依赖当前选中的对象所有对象通过名称或指针引用。 - 不直接将成品覆盖到最终路径先生成临时文件。 ## 执行方式 blender -b 目标文件.blend -P 脚本.py ## 完成标准 - 场景中必须有相机。 - 场景中必须有至少一个光源。 - 渲染输出路径必须存在。 - 脚本执行不能出现未捕获异常。checklist.md是为了让模型在最后阶段做一次自查- [ ] 场景单位是否为 Metric - [ ] 所有物体是否有语义化名称 - [ ] 是否设置了相机 - [ ] 是否设置了光源 - [ ] 渲染输出路径是否在项目目录内 - [ ] 材质是否使用节点 - [ ] 是否在 background mode 下验证过3.3 skill 与普通提示词的区别普通提示词也可以让模型遵守规则但每次都要重复写一遍而且写得越长模型越容易忽略中间部分。skill 把规则固化到文件里模型在执行相关任务时可以直接读取效果比散落在对话里的提示词更稳定。另一个好处是 skill 可以积累。你做完一个“天宫仙境”项目把建模规范沉淀成 skill下次做“海底龙宫”“未来城市”时可以复用同一套约束只需要改场景主题和资产清单。4. 把“天宫仙境”拆成可执行的建模任务4.1 从自然语言到模块表直接让 Codex 执行“创建一个天宫仙境”往往不会得到好结果因为这句话太抽象。我们需要把它拆成场景模块。最简单的做法是给 Codex 一段需求描述并附上输出约束。例如创建一座东方奇幻风格的浮空宫殿坐标原点作为岛屿中心。 周围分布云海时间是傍晚。 需要主光、补光、相机。 输出 1920x1080 PNG。 所有物体使用语义化名称。基于这个需求DeepSeek 会把场景拆成下面这张模块表模块关键对象建模方式说明浮岛FloatingIsland_Top/Bottom圆柱 圆锥表现悬浮山体结构宫殿主体PalaceHall立方体缩放作为中心建筑屋顶PalaceRoof圆锥体表现传统建筑屋顶柱子PalacePillar_01 等圆柱体围绕宫殿主体云海Cloud_001 等多球体组合分布在宫殿周围主光SunLight太阳光暖色傍晚光补光RimLight区域光冷色轮廓光相机MainCamera透视相机对准宫殿主体4.2 让 DeepSeek 输出结构化方案在 Codex 交互终端里你可以给出这样的任务请使用 blender-modeling skill完成一个“天宫仙境”场景。 需求 - 在原点创建浮空岛底部有锥形山体。 - 浮岛上方创建宫殿主体带一个圆锥屋顶。 - 宫殿周围放 4 根柱子。 - 在宫殿四周随机生成若干云朵球体。 - 设置暖色太阳光和冷色补光。 - 设置相机从侧前方 45 度观察宫殿。 - 渲染分辨率 1920x1080输出到 output/heaven_palace.png。 请先生成脚本再执行验证最后告诉我渲染结果文件路径。模型内部会先生成结构化方案。下面是一段示意性的 JSON不一定直接输出到终端{ scene: heaven_palace, center: [0, 0, 0], modules: [ { name: FloatingIsland, type: mesh, primitive: cylinder, params: { radius: 8, depth: 2, location: [0, 0, -1] } }, { name: PalaceHall, type: mesh, primitive: cube, params: { scale: [6, 4, 2], location: [0, 0, 4] } } ], render: { engine: CYCLES, samples: 128, resolution_x: 1920, resolution_y: 1080, filepath: output/heaven_palace.png } }结构化方案的价值在于Codex 生成脚本时不再需要重新思考“这个场景有什么”而是按照模块列表逐个创建对象。即使后续要加柱子也只需要在 JSON 的modules数组里增加一个元素。4.3 用 Codex 按 skill 执行如果你使用的 Codex 版本支持codex exec非交互模式可以在终端直接运行codex exec 请参考 blender-modeling skill创建天宫仙境场景脚本输出到 scripts/build_heaven_palace.py并渲染预览图到 output/如果不支持非交互模式就打开 Codex 交互终端输入同样的任务。Codex 会读取 skill生成脚本调用 Blender 后台命令然后根据输出结果判断是否继续修改。这里要注意权限问题。Codex 需要执行 shell 命令才能调用 Blender但不要给它无限制的系统权限。建议让它只允许在当前项目目录内写文件不要执行sudo、rm -rf这类危险操作。5. 核心脚本拆解浮岛、宫殿、云海与渲染5.1 初始化场景与收集对象先写一个最小可运行的 Blender Python 脚本。Codex 生成的脚本可能更复杂但结构通常是一致的。下面代码用于初始化场景、设置单位和创建集合import bpy import math def clear_scene(): bpy.ops.wm.read_factory_settings(use_emptyTrue) def setup_units(): scene bpy.context.scene scene.unit_settings.system METRIC scene.unit_settings.scale_length 1.0 def setup_collection(name): collection bpy.data.collections.new(name) bpy.context.scene.collection.children.link(collection) return collection在背景模式下bpy.ops.wm.read_factory_settings(use_emptyTrue)能清理默认场景避免脚本重复运行时出现多余的立方体、相机和灯光。5.2 生成浮岛和宫殿浮岛可以用圆柱体表示顶部平台用圆锥体表示底部山体。宫殿主体用立方体缩放屋顶用圆锥体。为了便于管理物体把对象统一放到指定集合里。def cleanup_to_collection(obj, collection): for c in obj.users_collection: c.objects.unlink(obj) collection.objects.link(obj) def build_floating_island(collection): bpy.ops.mesh.primitive_cylinder_add( radius8, depth2, vertices12, location(0, 0, -1) ) top bpy.context.active_object top.name FloatingIsland_Top cleanup_to_collection(top, collection) bpy.ops.mesh.primitive_cone_add( vertices8, radius16, radius20, depth7, location(0, 0, -6) ) bottom bpy.context.active_object bottom.name FloatingIsland_Bottom cleanup_to_collection(bottom, collection) def build_palace(collection): bpy.ops.mesh.primitive_cube_add(size2, location(0, 0, 4)) hall bpy.context.active_object hall.name PalaceHall hall.scale (6,