PopNowAPI 文档
集成
正文

Blender AI 渲染插件

把 Blender 的相机视角或泥塑预览变成 AI 渲染图、AI 视频和无缝贴图,使用免费的 PopNow 插件。包括安装、API 密钥、模型与美元价格,以及背后的 REST 调用。

免费的 PopNow Blender 插件会在 3D 视图侧栏添加一个 PopNow 标签。用灰色几何体搭好场景、用相机取景,PopNow 就能把它变成保留构图的成片、跟随镜头运动的短视频,或应用到选中物体上的无缝纹理。插件使用你的 PopNow API 密钥,扣独立的 API 美元余额,初始为 $0。请在 API 账单充值;网站积分不能支付插件生成。

可以在 popnow.ai 上的 Blender 插件页面下载(当前版本 0.1.0,约 58 KB,支持 Windows、macOS 和 Linux,需要 Blender 4.2 或更新版本)。

两个人坐在咖啡桌旁的灰色泥塑渲染图
同一场景渲染成的阳光咖啡馆,里面坐着两个人
泥塑渲染进,成品画面出:Seedream 5.0 Pro 加两张参考照片,$0.036 USD。

功能

工作流输入输出
AI 渲染相机或视口渲染出的干净灰色泥塑图,可选深度或线稿通道,最多三张参考照片在图像编辑器中得到成品图;可选择设为相机背景,或投影到你的网格上
AI 动画相机动画的一段快速 Workbench 预览一个 MP4,保留你的相机运动、布局和节奏,可直接放入视频序列编辑器
无缝贴图对材质和风格的描述(照片扫描、手绘、卡通)边缘融合的方形贴图,配合盒式投影的材质,应用到选中的物体上

三步安装

下载 zip 包

从 popnow.ai/blender 获取 popnow-blender-0.1.0.zip。不要解压。插件是开源的:代码位于 GitHub 上的 popnow-blender,那里也可以构建出同样的 zip。

在 Blender 中安装

在 Blender 4.2 或更新版本中,把 zip 拖进 Blender 窗口。或者打开 Edit › Preferences › Get Extensions,点击右上角的菜单,选择 Install from Disk,然后选中 zip。第一次使用时 Blender 会询问是否允许在线访问;PopNow 需要它来发送渲染图和下载结果。

粘贴你的 API 密钥

在 3D 视图中按 N,打开 PopNow 标签页,点击 Get API key,在 API 控制台中创建一个密钥,然后粘贴进去。你的余额会立即显示。

一次渲染是怎样的

  1. 用相机取景,或把面板切换到 Viewport。
  2. 写下你想看到的效果,选择风格和模型。按钮上会显示价格。
  3. 插件渲染出泥塑图、上传,并获得精确的报价。
  4. 点击 Start。Blender 在运行期间保持响应;进度显示在 Tasks 面板中。
  5. 结果在图像编辑器中打开,并保存在 .blend 文件旁边的 popnow 文件夹里。
放在底座上的灰色泥塑瓶子
渲染成产品图的瓶子
底座上的泥塑瓶子渲染成产品图:Nano Banana 2.1 加一张产品照片,$0.048 USD。

模型与价格

API 按美元计价,与网站相同模型的价格一致。下表只是价格示例;准确模型、设置和当前价格请获取实时报价。面板会显示你所选设置的预估费用,开始前再由你确认准确报价。

工作流模型适合美元价格示例
渲染Seedream 5.0 Pro均衡;紧贴你的布局约 $0.036 /1K 图片
渲染Seedream 5.0 Flash更快、更便宜约 $0.029
渲染Nano Banana 2.1参考图多时效果最好约 $0.048
渲染GPT Image 2文字与细节出色约 $0.04254 (方形、中等质量、1K)
渲染Qwen-Image 2.1 Turbo最便宜的草稿约 $0.0144
渲染FLUX.1 dev ControlNet通过深度或线稿通道精确还原形状;不需要参考图约 $0.036
动画Seedance 2.0 Mini最便宜,适合草稿按你的视频实时报价
动画Seedance 2.0 Fast价格与质量兼顾按你的视频实时报价
动画Seedance 2.0质量更高,最高 4K按你的视频实时报价
动画Seedance 2.5最能遵循泥塑预览按你的视频实时报价
动画Wan 3.0运动感强,最高 1080p按你的视频实时报价
动画Kling O3 Restyle逐帧重绘你的片段,3 到 10 秒按你的视频实时报价
动画Wan 2.2 Animate动作控制:你的角色模仿泥塑人物按你的视频实时报价
贴图Seedream 5.0 Flash快速、便宜约 $0.029 /1K 图片
贴图Qwen-Image 2.1 Turbo最便宜约 $0.0144
贴图Seedream 5.0 Pro细节最丰富约 $0.036
贴图Nano Banana 2.1最高 4K约 $0.048

生成失败后,冻结的 API 资金会自动释放,Tasks 面板也会说明。见 API 余额与退款。

背后的 API 调用

这个插件就是一个普通的 API 客户端:它上传泥塑渲染图、获取报价、创建任务,然后轮询结果。如果你想自己编写 Blender 脚本,或者想在渲染农场上得到同样的结果,可以直接调用 API。下面是 AI 渲染使用 Seedream 5.0 Pro 时的做法:

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "bytedance/seedream-5.0-pro/edit", "input": {"prompt": "Turn this clay render into a sunlit cafe photo. Keep the camera, layout and silhouettes exactly.", "image_urls": ["popnow://f/fil_clay_render"], "aspect_ratio": "16:9", "resolution": "1k"}}'
Python (bpy scripts can use the same code)
import os, time, uuid, requests

API = "https://api.popnow.ai/api/v1"
H = {"Authorization": f"Bearer {os.environ['POPNOW_API_KEY']}"}

def upload(path):
    data = open(path, "rb").read()
    ticket = requests.post(f"{API}/common/upload-url", headers=H, json={"contentType": "image/png", "bytes": len(data)}, timeout=30).json()["data"]
    requests.put(ticket["uploadUrl"], data=data, headers=ticket.get("headers", {}), timeout=120).raise_for_status()
    return requests.post(f"{API}/files/{ticket['fileId']}/commit", headers=H, timeout=30).json()["data"]["uri"]

clay = upload("/tmp/clay_render.png")
task = requests.post(
    f"{API}/jobs/createTask",
    headers={**H, "Idempotency-Key": str(uuid.uuid4())},
    json={
        "model": "bytedance/seedream-5.0-pro/edit",
        "input": {"prompt": "Turn this clay render into a sunlit cafe photo. Keep the camera, layout and silhouettes exactly.", "image_urls": [clay], "aspect_ratio": "16:9"},
    },
    timeout=30,
).json()["data"]

while task["state"] in ("queued", "running"):
    time.sleep(3)
    task = requests.get(f"{API}/jobs/recordInfo", headers=H, params={"taskId": task["taskId"]}, timeout=30).json()["data"]
print(task["state"], task.get("output", {}).get("assets", [{}])[0].get("url"))
JavaScript
const res = await fetch('https://api.popnow.ai/api/v1/jobs/quote', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.POPNOW_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    model: 'bytedance/seedream-5.0-pro/edit',
    input: { prompt: 'Turn this clay render into a sunlit cafe photo.', image_urls: ['https://media.popnow.ai/movie/lighthouse.webp'], aspect_ratio: '16:9' },
  }),
});
console.log((await res.json()).data.maxChargeUsd, 'USD at most');

把 popnow://f/fil_clay_render 替换为你自己上传时返回的 URI;见上传与下载。

哪些内容会离开你的电脑

  • 只有渲染出的泥塑图或预览片段,以及你选择的参考图。你的 .blend 文件、网格和贴图都留在你的电脑上。
  • 你的 API 密钥保存在 Blender 的偏好设置中,绝不会写入 .blend 文件,所以分享项目不会泄露你的密钥。
  • 结果下载到 .blend 文件旁边的 popnow 文件夹,或你选择的文件夹。

常见错误

你看到的原因解决方法
PopNow 标签页要求输入密钥还没有保存密钥,或密钥已被撤销在 API 控制台创建一个密钥并粘贴进去
插件无法连接 PopNowBlender 的 Allow Online Access 被关闭,或防火墙拦截了 api.popnow.ai在 Preferences › System › Network 中开启
API 余额不足报价高于你的余额在 API 账单充值,或换更便宜的模型、降低分辨率或缩短视频
视频忽略了泥塑人物模型更偏向提示词,而不是预览使用 Seedance 2.5,或用 Wan 2.2 Animate 处理角色
形状偏离了你的布局图像模型会重新解读轮廓使用 FLUX.1 dev ControlNet,并配合深度或线稿通道
点了「Stop waiting」,但任务仍在运行已开始的任务会在 PopNow 上运行到结束之后在 Tasks 面板中恢复,即可下载结果

Blender 插件免费吗?

免费。插件本身不收费;每次生成使用独立的 API 美元余额,开始前会显示价格。

支持哪些 Blender 版本?

Windows、macOS 和 Linux 上的 Blender 4.2 及更新版本。它以 Blender 扩展的形式安装,不需要额外的 Python 包。

我需要 GPU 吗?

不需要。生成在 PopNow 上运行。你的电脑只负责快速生成一张 Workbench 泥塑渲染图;如果你要深度、法线或线稿,还会额外做一次单采样的 Cycles 渲染。

我可以改用本地的 Stable Diffusion 模型吗?

不可以。插件调用的是托管在 PopNow 上的模型。如果你想要一个既能在本地运行、又能调用云端模型的图,请使用 ComfyUI 节点。

Blender 是 Blender Foundation 的注册商标。PopNow 与 Blender Foundation 没有关联,也未获其认可。

本页内容