PopNowAPI ドキュメント
連携
本文

Blender で使う AI レンダリングのアドオン

無料の PopNow アドオンで、Blender のカメラビューやクレイのプレビズを AI の画像、AI 動画、継ぎ目のないテクスチャに変えます。インストール、API キー、モデルと USD 料金、その裏にある REST 呼び出し。

無料の PopNow アドオンを入れると、Blender の 3D ビューポートのサイドバーに PopNow タブが追加されます。グレーの形でシーンを組み、カメラで構図を決めると、PopNow がそれを描き上げます。構図を保った完成画像、カメラの動きに沿った短い動画、または選択したオブジェクト用の継ぎ目のないテクスチャが得られます。PopNow の API キーを使い、独立した API USD 残高から支払います。初期残高は $0 です。API billing で入金してください。ウェブサイトのクレジットはアドオンの実行に使えません。

popnow.ai の Blender アドオンページからダウンロードできます(現在のバージョンは 0.1.0、約 58 KB、Windows・macOS・Linux 対応、Blender 4.2 以降)。

カフェのテーブルに座る 2 人のグレーのクレイレンダー
同じシーンを、日差しの差すカフェで 2 人が座る絵として描いたもの
クレイのレンダリングを入れると完成したフレームが出てきます。Seedream 5.0 Pro に参照写真 2 枚を添えて、$0.036 USD。

機能

ワークフロー入力出力
Render with AIカメラまたはビューポートを、きれいなグレーのクレイとしてレンダリングしたもの。任意で深度またはラインのパス、参照写真は最大 3 枚Image Editor に完成画像。任意でカメラの背景に設定するか、メッシュに投影
Animate with AIカメラアニメーションの Workbench による簡易プレビューカメラの動き、ブロッキング、タイミングを保った MP4。Video Sequencer にそのまま入れられる
Seamless texture素材と様式(写真スキャン、手描き、トゥーン)の説明エッジをなじませた正方形のテクスチャ。ボックス投影を使うマテリアルとして、選択したオブジェクトに適用

3 つの手順でインストール

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. 結果は Image Editor で開き、.blend ファイルの隣の popnow フォルダーに保存されます。
台座の上に置かれたグレーのクレイのボトル
ボトルを商品写真として描き上げたもの
台座の上のクレイのボトルを商品写真として描き上げたもの。Nano Banana 2.1 に商品写真 1 枚を添えて、$0.048 USD。

モデルと料金

API の料金は USD 建てで、ウェブサイトと同じモデルの料金基準です。以下は見積もりの例です。モデル、設定、現在の料金に応じた正確な額は、その都度見積もってください。パネルには設定に応じた見積もりが表示され、開始前に正確な額を確認します。

ワークフローモデル向いている用途USD 料金の例
RenderSeedream 5.0 Proバランスがよく、構図に忠実約 $0.036 /1K 画像 1 枚
RenderSeedream 5.0 Flashより速く、安い約 $0.029
RenderNano Banana 2.1参照画像が多いときに最適約 $0.048
RenderGPT Image 2文字と細部の表現が強い約 $0.04254 (正方形、medium、1K)
RenderQwen-Image 2.1 Turbo最も安い下書き約 $0.0144
RenderFLUX.1 dev ControlNet深度またはラインのパスから形を正確に再現。参照画像は不要約 $0.036
AnimateSeedance 2.0 Mini最も安く、下書きに向くクリップに応じた最新の見積もり
AnimateSeedance 2.0 Fast価格と品質のバランスクリップに応じた最新の見積もり
AnimateSeedance 2.0高品質、4K までクリップに応じた最新の見積もり
AnimateSeedance 2.5クレイのプレビズに最もよく従うクリップに応じた最新の見積もり
AnimateWan 3.0力強い動き、1080p までクリップに応じた最新の見積もり
AnimateKling O3 Restyleクリップをフレームごとに描き直す、3〜10 秒クリップに応じた最新の見積もり
AnimateWan 2.2 Animateモーションコントロール。キャラクターがクレイの人物の動きをなぞるクリップに応じた最新の見積もり
TextureSeedream 5.0 Flash速く、安い約 $0.029 /1K 画像 1 枚
TextureQwen-Image 2.1 Turbo最も安い約 $0.0144
TextureSeedream 5.0 Pro最も細部まで描ける約 $0.036
TextureNano Banana 2.14K まで約 $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 コンソールでキーを作成して貼り付けてください
アドオンが PopNow に接続できないBlender の Allow Online Access がオフ、またはファイアウォールが api.popnow.ai をブロックしているPreferences › System › Network でオンにしてください
API 残高が足りない見積もりが残高を超えているAPI billing で入金するか、より安いモデル、低い解像度、短いクリップを選んでください
動画がクレイの人物を無視するモデルはプレビズより、プロンプトによく従うSeedance 2.5 を使うか、キャラクターには Wan 2.2 Animate を使ってください
形がレイアウトからずれる画像モデルは輪郭を解釈し直す深度またはラインアートのパスとともに FLUX.1 dev ControlNet を使ってください
「Stop waiting」を押したのにジョブが動き続ける開始されたジョブは PopNow 上で最後まで実行されるあとで Tasks パネルから再開して、ダウンロードしてください

Blender アドオンは無料ですか?

はい。アドオン自体は無料です。各生成は独立した API USD 残高を使い、開始前に料金が表示されます。

対応している Blender のバージョンは?

Windows、macOS、Linux 上の Blender 4.2 以降です。追加の Python パッケージは要らず、Blender の拡張機能としてインストールされます。

GPU は必要ですか?

いいえ。生成は PopNow で行われます。お使いのコンピューターがするのは、Workbench による手早いクレイのレンダリングだけです。深度、法線、ラインアートを指定した場合は、Cycles の 1 サンプルのパスも加わります。

代わりにローカルの Stable Diffusion モデルを使えますか?

いいえ。アドオンが呼び出すのは PopNow でホストされているモデルです。クラウドのモデルも呼び出すローカルのグラフを組みたい場合は、ComfyUI ノードを使ってください。

Blender は Blender Foundation の登録商標です。PopNow は Blender Foundation と提携しておらず、同財団の承認も受けていません。

このページの内容