scenario-labs/blender-plugin

Scenario for Blender – 在 Blender 中实现 AI 驱动的内容生成

它是什么 – 一个 Blender 插件（Python 扩展），允许你直接从 3D 创作环境调用 Scenario 的云 AI 服务。它可以根据自然语言提示或参考资产生成图像、视频、3D 网格、PBR 材质、音频、360° 环境甚至完整的布局草图，然后将结果导入当前 Blender 场景。

主要功能

• 图像和视频生成 – 将文本提示或参考图像转换为纹理、背景板或完整长度的视频片段。
• 3D 网格创建和编辑 – 让 AI 创建新几何体或对选定网格应用编辑，然后将编辑后的网格导入 Blender。
• 材质合成 – 生成完整的 PBR 纹理集，并自动分配给材质槽。
• 音频合成 – 生成语音、音乐或音效，并将其放置在视频序列编辑器中。
• 渲染辅助生成 – 使用场景捕获（静态或视频）作为视觉提示，让 AI 生成匹配的资产。
• 布局工具 – 提供简短的场景描述，获得可进一步细化的灰盒布局。
• 环境创建 – 生成 HDRI 全景或放大后的 360° 背景，并将其应用于世界环境。
• 工作室视图和浮动合成器 – UI 面板，让你无需离开视口即可运行上述“通道”。
• MCP 代理 – 本地 scenario-blender 服务器可以将场景暴露给外部代理（例如 Claude Code、Cursor），这些代理可以读取场景并代表你请求付费 AI 工作。服务器运行在 http://127.0.0.1:9876/mcp，也可以通过 blender --background … --command scenario_blender 以无头模式使用。

如何获取

1. 在 Blender 中启用在线访问（编辑 → 偏好设置 → 系统 → 网络）。
2. 通过 编辑 → 偏好设置 → 获取扩展 → 添加远程仓库 添加远程仓库 https://blender.scenario.com/repo/index.json。
3. 从列表安装“Scenario”；插件出现在 偏好设置 → 插件 中。
4. 将你的 Scenario API 密钥/秘密（从 Scenario 网页控制台获取）粘贴到插件的凭据面板中，并测试连接。
5. 选择输出文件夹；生成的资产将保存在那里，并出现在 生成 面板中。

（你也可以从 GitHub 发布页面下载 ZIP 并手动安装，但该副本不会自动更新。）

典型工作流程

1. 打开 Scenario 侧边栏（视口中的 N）。
2. 选择一个通道（图像、3D、音频等），编写提示，附加任何参考文件，并查看成本估算（Scenario 收取 创意单位）。
3. 点击 生成 – 插件将请求发送到 api.cloud.scenario.com，接收结果，并存储在本地。
4. 使用提供的操作导入资产（例如，应用生成的纹理、添加网格、将音频放置在序列编辑器上）。
5. 迭代或组合多个通道以构建完整场景。

限制和注意事项

• 需要付费的 Scenario 账户；每次生成消耗积分（创意单位）。
• 所有提示、参数和参考文件在生成前都会发送到 Scenario 的云服务；隐私详情见仓库中的 PRIVACY.md。
• 该插件标记为 实验性 – 某些通道可能不可用或在某些 Blender 版本上功能受限。
• 代理（MCP）如果选择加入，可以执行任意 Python 代码，这存在安全风险；默认情况下禁用。
• 离线 ZIP 安装不会收到自动更新；你必须重新安装才能获得新功能或错误修复。

许可证 – 扩展代码根据 GPL-3.0-or-later 发布（Blender 插件所需）。捆绑的 SDK 轮子保留其原始许可证；详情见 LICENSE、SDK_BUNDLE.md 和 TRADEMARKS.md。

了解更多

• 用户指南：docs/USER_GUIDE.md（涵盖每个通道、成本预览、输出处理）。
• API 文档：https://docs.scenario.com。
• MCP 协议参考：docs/MCP.md。
• 支持：通过仓库的 支持 页面或发送电子邮件至 support@scenario.com 打开问题（不要公开发布凭据）。

---

Scenario for Blender 将生成式 AI 直接带入 3D 创作循环，让艺术家无需离开 Blender 即可原型化资产、环境甚至整个场景。