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。

功能

功能輸入輸出
Render with AI攝影機或 Viewport 渲染成乾淨的灰色黏土,可選擇深度或線稿通道,最多三張參考照片Image Editor 中的完成圖;也可以選擇設為攝影機背景,或投射到你的網格上
Animate with AI攝影機動畫的快速 Workbench 預覽一個 MP4,保留你的攝影機運鏡、走位與時間節奏,可直接拖進 Video Sequencer
Seamless texture材質與風格的描述(照片掃描、手繪、卡通)邊緣融合的正方形貼圖,搭配使用 box projection 的材質,套用在選取的物件上

三個步驟安裝

下載 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 Viewport 中按下 N,打開 PopNow 分頁,點選 Get API key,在 API 控制台 建立金鑰並貼上。你的餘額會立即顯示。

渲染的流程

  1. 用攝影機取好鏡頭構圖,或把面板切換到 Viewport。
  2. 寫下你想看到的畫面,選擇風格與模型。按鈕會顯示價格。
  3. 附加元件會渲染黏土圖、上傳,並取得精確的報價。
  4. 點選 Start。執行期間 Blender 仍可正常操作;進度會顯示在 Tasks 面板中。
  5. 結果會在 Image Editor 中開啟,並儲存在你 .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。以下是 Render with 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 沒有隸屬關係,也未獲其背書。

本頁內容