安装
插件、MCP 服务器或 CLI。
插件和 MCP 服务器通过 uvx 在你的电脑上运行，所以能渲染你已有的 .blend 文件。首次调用会打开浏览器让你登录。
在命令行中添加插件。它带来这些工具和同样的技能。每次工具调用都会在 50 秒内返回，低于 Codex 60 秒的工具超时限制。
shell
codex plugin marketplace add loopcut-ai/loopcut
codex plugin add loopcut@loopcut或者只添加 MCP 服务器。
shell
codex mcp add loopcut -- uvx loopcut mcp或使用托管服务器
无需在本地运行任何东西。它同样能渲染：助手会把场景写成 Blender 脚本。要渲染你已有的 .blend 文件，请使用上面的插件。
第二条命令会打开浏览器让你登录。
shell
codex mcp add loopcut --url https://loopcut.org/mcp
codex mcp login loopcut在会话中
报价、启动、取回文件。
所有付费工具都遵循同样的流程：免费报价，你同意后启动，然后得到 Codex 用 Blender 的 Python 导入的文件。模型、图片、动作和音频的流程与渲染相同。
- 01
Codex 搭建场景
用 Blender 的 Python 以无界面模式搭建，或通过控制你打开的 Blender 的 MCP 服务器搭建。然后保存 .blend 文件。
- 02
render_quote 给出报价
用你的 Blender 打包已保存的 .blend 文件，只上传新增的内容，并为渲染报价。免费。
- 03
job_start 运行任务
在你同意报价之后。调用两次会返回同一个任务，绝不会重复扣费。
- 04
job_status 取回帧
等待任务完成，然后下载结果，带哈希校验并支持断点续传。质检报告会标出值得查看的帧。
CI 与无界面模式
在流水线中使用相同的命令。
每晚渲染转台动画，或从构建中渲染整份镜头列表。把账号页面上的 API 密钥保存为 LOOPCUT_API_KEY，在 CI 运行器上安装 Blender 用于打包场景，并设置积分上限：只有报价低于上限时任务才会启动。
github actions
- run: uvx loopcut render scenes/hero.blend --frames 1-240 --max-credits 500 --out renders/
env:
LOOPCUT_API_KEY: ${{ secrets.LOOPCUT_API_KEY }}常见问题
- Codex 能使用 Blender 吗？
- 能。Codex 可以编写 Blender Python 并以无界面模式运行 Blender，Loopcut 的插件还为它增加了云工具：在 RTX 4090 上渲染、资产搜索、图片、3D 模型、角色动作、配音台词和音效，费用从 Loopcut 积分中支付。
- 用插件还是 MCP 服务器？
- 插件包含这些工具，以及一个教给智能体省钱习惯的技能：先搜索资产再生成，长动画前先渲染一帧低分辨率测试帧，确认完成前先检查结果。codex mcp add loopcut -- uvx loopcut mcp 只添加工具。
- 长时间渲染会触发 Codex 的工具超时吗？
- 不会。每次调用都会在 50 秒内返回，低于 Codex 60 秒的限制。更长的任务会在云端继续运行，完成后由 job_status 接手并下载帧。
- 它会控制我打开的 Blender 吗？
- 不会。它用你的 Blender 以无界面模式打包已保存的 .blend 文件，然后在云端渲染。要编辑打开的场景，可以同时使用 MCP for Blender 或 Blender Lab MCP 服务器。
- 可以不用智能体，直接从 CI 渲染吗？
- 可以。在账号页面创建 API 密钥，设置 LOOPCUT_API_KEY，在 CI 运行器上安装 Blender 用于打包场景，然后带上 --max-credits 运行 CLI：只有报价低于这个上限时任务才会启动。
- 费用是多少？
- 免费安装。云任务用 Loopcut 积分支付（1 积分 = US$0.01），运行前先报价。渲染在 RTX 4090 上每 GPU 分钟 US$0.05，最少按 1 分钟计费，免费套餐每月提供 100 积分。