What is an MCP server, and what does the Luw.ai MCP server do?

MCP (Model Context Protocol) is an open standard that lets AI assistants such as Claude, ChatGPT and Cursor call outside tools. The Luw.ai MCP server gives them 21 design tools — interior, exterior and landscape design, virtual staging, sketch and CAD to render, image editing, video and image to 3D — so you can ask for a design in plain language and get the result in the chat.

Is the Luw.ai MCP server free?

Connecting is free and the server is open source. Each generation spends Luw.ai credits — 1 credit for most designs — and new accounts get free credits to try it. The Free plan adds 2 credits every day at 512px with a watermark; paid plans give 4K without a watermark.

How do I add Luw.ai to Claude?

In claude.ai or Claude Desktop, open Settings, then Connectors, choose Add custom connector, paste https://mcp.luw.ai/mcp, click Connect and sign in to Luw.ai. In Claude Code, run claude mcp add --transport http luw https://mcp.luw.ai/mcp --scope user, then type /mcp and sign in.

How do I connect Luw.ai to ChatGPT?

In ChatGPT, open Settings, then Apps & Connectors, then Advanced settings, and turn on Developer mode. Click Create, enter https://mcp.luw.ai/mcp as the URL, choose OAuth and sign in to Luw.ai.

Which AI assistants and code editors are supported?

Claude (claude.ai, Claude Desktop, mobile and Claude Code), ChatGPT, Cursor, VS Code with GitHub Copilot, Windsurf, OpenAI Codex CLI, Gemini CLI and Kiro have step-by-step setups. Any other client that supports remote MCP over Streamable HTTP, or local stdio servers, works too.

Can Claude Code or Cursor generate images with an MCP server?

Yes. With Luw.ai connected, luw_generate_image creates images from text with Fluw AI, or SVG vectors, and the other tools edit, upscale, render and animate images. Run the local server and the assistant can work on image files in your project folder directly.

Do I need an API key to use the MCP server?

Not for the hosted server: clients that support MCP sign-in let you log in to Luw.ai, and the sign-in creates a key for you. The local server, and clients that can't sign in, use a key you create on the API page at app.luw.ai/dashboard/api.

Can the MCP server use images on my computer?

The local server can: give it a path such as ~/Desktop/room.jpg and it uploads the file as a temporary file that is deleted after 12 hours. The hosted server cannot read your disk, so give it an image URL or attach the image in a client that passes it through.

Does Luw.ai work with AutoCAD, Revit, SketchUp or Blender?

Yes, through what they export. Connect the AutoCAD, Revit, SketchUp, Rhino, Archicad, 3ds Max or Blender MCP server you use next to Luw.ai, and your assistant can pass a viewport, plan or screenshot to Luw.ai for a photoreal render, an edit, a video or a 3D model. Luw.ai does not control those applications and is not affiliated with their makers.

Is there an interior design API or a virtual staging API?

Yes. The interior model of the Luw.ai REST API redesigns a room photo in the style you choose and can furnish an empty room for virtual staging. The same API covers exterior and landscape design, sketch and CAD to render, upscaling, background removal, image to video and image to 3D.

Should I use the MCP server or the API?

Use the MCP server when a person works through an AI assistant and wants to ask in plain language. Use the REST API when your own software calls Luw.ai — a website, an app or a batch pipeline. Both use the same API keys and credits, so many teams use both.

Can I white-label Luw.ai?

Yes. On the E3 and Custom plans the Luw.ai branding is removed from outputs and you can add your own logo, and team plans include an extended license with branding and resale rights. To build your own product or resell Luw.ai in your market, apply at app.luw.ai/partners.

Will I be charged twice if a request fails and I retry it?

No. The MCP server sends an Idempotency-Key with every generation, so a retry returns the original job instead of a new charge. Do the same in your own API calls by sending an Idempotency-Key header when you retry a request.

Is the Luw.ai MCP server open source, and can I host it myself?

Yes. The server is MIT-licensed on GitHub at Luvi-io/luw-mcp and published to npm as @luw-ai/mcp. Run npx -y @luw-ai/mcp --http, or the included Dockerfile, to host the Streamable HTTP endpoint yourself; it is stateless and each request brings its own key.

Can I use the images commercially?

On paid plans, yes: Pro and above include a commercial license, and team plans add an extended license. Output made on the Free plan carries a watermark and is for personal use only.

Luw.ai API & MCP

Luw.ai API & MCPサーバー

AIインテリアデザイン & レンダリングのMCPサーバーとAPI

Claude、ChatGPT、Cursor、VS Code など、あらゆる MCPクライアントに URL ひとつで21種類のプロ向けデザインツールを。REST API なら自社プロダクトに組み込めます。内装・外観デザイン、バーチャルステージング、スケッチや CAD からのフォトリアルなレンダリング、画像編集、動画、画像から 3D まで対応します。

MCP URL https://mcp.luw.ai/mcp

Cursor に追加 VS Code にインストール Claude Desktop 拡張機能 Claude、ChatGPT ほか7種類

APIキーを取得ホワイトラベル & パートナー

ホスト型サーバーならインストール不要：URL を追加してサインインするだけです。新規アカウントには無料クレジット付き — クレジットカードは不要です。

お使いの AIアシスタント luw 接続済み

~/Desktop/bedroom.jpg を、温かみのあるモダンなホテルスイート風にリデザインして。2案ほしい。

⟶ luw_interior_design ✓ 21秒で2案

luw_interior_design でモダンなホテルスイート風にリデザインした寝室 — アフター

2つ目がいいね。ヘッドボードをウォールナットにして、ゆっくり進むフライスルー動画にして。

⟶ luw_edit_image ⟶ luw_generate_video ✓

完了しました — ウォールナット版とシネマティックな動画ができあがりました。

21デザイン業務向けの MCPツール

10+対応する AIアシスタントとエディタ

1クレジットほとんどのツールで1デザインあたり

MITオープンソースの MCPサーバー

世界をリードする企業から信頼されています

最高の内装・外装AI

500以上のニュースサイトで紹介

ひとつのアカウント、共通のキー

Luw.ai を活用する2つの方法

MCPサーバーを使えば、AIアシスタントがあなたの代わりに、普段の言葉で Luw.ai を操作します。REST API を使えば、自社のソフトウェアから同じモデルを直接呼び出せます。どちらも同じ APIキーと同じクレジットを使います。

MCPサーバー

AIアシスタントで仕事をする人に

Claude、ChatGPT、Cursor、Copilot にデザインを頼むだけで、最適な Luw.ai ツールを呼び出し、結果を待ってチャットに表示します。リデザイン、編集、アップスケール、アニメーション化まで、ひとつの会話でステップをつなげられます。

ホスト型：https://mcp.luw.ai/mcp を追加してサインイン
ローカル：npx -y @luw-ai/mcp でパソコン上のファイルを読み込み
建築家、デザイナー、不動産エージェント、不動産チームに

MCP をセットアップ

REST API

プロダクト、プラットフォーム、パイプラインに

画像とモデル名をひとつのエンドポイントに送り、結果をポーリングするだけ。物件ポータルにバーチャルステージングを、家具店にルームビジュアライゼーションを、CAD パイプラインにレンダリング工程を組み込めます。

POST https://api.luw.ai/v2/generate の後に /results
Bearer トークン認証、冪等なリトライ、バッチワークフロー
E3・カスタムプランではホワイトラベル出力

API を見る

Luw.ai 公式 MCPサーバー

Claude、ChatGPT、Cursor のためのインテリアデザイン・建築 MCPサーバー

MCP（Model Context Protocol）は、AIアシスタントが外部ツールを呼び出すためのオープン標準です。Luw.ai MCPサーバーを一度接続すれば、アシスタントが部屋のリデザイン、空室物件のステージング、スケッチや CAD ビューのレンダリング、画像編集、動画制作、3Dモデル作成までこなします — Luw.ai アプリと同じモデルで。

ホスト型：インストール不要

クライアントに https://mcp.luw.ai/mcp を追加し、Luw.ai にサインインします。サインインするとキーが自動で作成されるので、キーをコピーする必要はありません。接続を解除するには、API ページでそのキーを削除します。

ローカル：手元のファイルで動く

APIキーを設定して npx -y @luw-ai/mcp を実行すれば、アシスタントが ~/Desktop/room.jpg のようなパスを扱えます。ローカルファイルは一時ファイルとしてアップロードされ、12時間後に削除されます。

結果はチャットに表示

完成した画像はツールの結果に埋め込まれるため、アシスタントがそのままチャット内に表示します。LUW_OUTPUT_DIR を設定すれば、すべての画像、動画、GLB、SVG をディスクにも保存できます。

長いジョブもタイムアウトしない

1回の呼び出しは最大50秒待機し、進捗をストリーミングします。動画など時間のかかるジョブでは、ツールが processing_url を返し、アシスタントが luw_get_result で結果を回収します — 生成も支払いも二重になりません。

二重請求なし

すべての生成リクエストには Idempotency-Key が付きます。ネットワークエラーで再試行が必要になっても、Luw.ai は再度課金せず、元のジョブを返します。

マスクは自動で作成

「床をヘリンボーンのオークに変えて」と言えば、アシスタントが luw_segment で床を切り出し、luw_magic_wand で素材を差し替えます。手作業のマスキングは不要です。

1分以内でセットアップ

お使いの AIアシスタントに Luw.ai を追加

クライアントを選んでください。ホスト型は URL とサインインだけで完了します。ローカル型には Node.js 18 以上と、API ページで取得した APIキーが必要です。API ページでは、キー入力済みの設定スニペットも作成できます。

CClaude（claude.ai、Claude Desktop、モバイル）
ホスト型 · サインイン

設定 → コネクタ → カスタムコネクタを追加を開きます。
下の URL を貼り付けて接続をクリックし、Luw.ai にサインインします。

コネクタ URL

https://mcp.luw.ai/mcp

>_Claude Code
ホスト型またはローカル

ホスト型サーバーを追加したら、/mcp と入力して luw を選び、サインインします。

Terminal

claude mcp add --transport http luw https://mcp.luw.ai/mcp --scope user

ローカルファイルを読み込むには、代わりにローカルで実行してください。プラグインをインストールすれば、キーを安全なストレージに保管できます：

Terminal

claude mcp add luw --scope user --env LUW_API_KEY=YOUR_LUW_API_KEY -- npx -y @luw-ai/mcp

# or as a plugin
claude plugin marketplace add Luvi-io/luw-mcp
claude plugin install luw@luw-ai

GChatGPT
ホスト型 · サインイン

設定 → アプリとコネクター → 詳細設定を開き、開発者モードをオンにします。
作成をクリックして URL を貼り付け、認証方式に OAuth を選んで Luw.ai にサインインします。

コネクタ URL

https://mcp.luw.ai/mcp

CuCursor
ワンクリック、ホスト型またはローカル

Cursor に追加を使うか、~/.cursor/mcp.json に以下を追加します。Cursor で luw の横に Needs login と表示されたら、クリックしてサインインします。

~/.cursor/mcp.json

{
  "mcpServers": {
    "luw": { "url": "https://mcp.luw.ai/mcp" }
  }
}

VSVS Code（GitHub Copilot）
ワンクリック、ホスト型またはローカル

VS Code にインストールを使うか、.vscode/mcp.json に以下を追加します。ツールを初めて実行するときに、VS Code がサインインを求めます。

.vscode/mcp.json

{
  "servers": {
    "luw": { "type": "http", "url": "https://mcp.luw.ai/mcp" }
  }
}

WWindsurf
ローカル

~/.config/devin/mcp_config.json に追加します（Windows：%APPDATA%\devin\mcp_config.json）。古いバージョンの Windsurf では ~/.codeium/windsurf/mcp_config.json を使います。

mcp_config.json

{
  "mcpServers": {
    "luw": {
      "command": "npx",
      "args": ["-y", "@luw-ai/mcp"],
      "env": { "LUW_API_KEY": "YOUR_LUW_API_KEY" }
    }
  }
}

CxOpenAI Codex CLI
ローカル

Terminal

codex mcp add luw --env LUW_API_KEY=YOUR_LUW_API_KEY -- npx -y @luw-ai/mcp

Or in ~/.codex/config.toml:

config.toml

[mcp_servers.luw]
command = "npx"
args = ["-y", "@luw-ai/mcp"]
env = { LUW_API_KEY = "YOUR_LUW_API_KEY" }

GeGemini CLI
拡張機能、ローカル

拡張機能をインストールします。Gemini CLI がキーの入力を求め、システムのキーチェーンに保管します。

Terminal

gemini extensions install https://github.com/Luvi-io/luw-mcp

CDClaude Desktop（ローカル）
ワンクリック拡張機能

luw.mcpb をダウンロードしてダブルクリックし、APIキーを貼り付けるだけ — Node.js は不要です。または claude_desktop_config.json（設定 → 開発者 → 構成を編集）に以下を追加します：

claude_desktop_config.json

{
  "mcpServers": {
    "luw": {
      "command": "npx",
      "args": ["-y", "@luw-ai/mcp"],
      "env": { "LUW_API_KEY": "YOUR_LUW_API_KEY" }
    }
  }
}

KKiro
ワンクリック、ローカル

Kiro に追加を開いて確定し、Kiro の MCP 設定で YOUR_LUW_API_KEY を置き換えます。

+その他の MCPクライアント
Streamable HTTP · OAuth またはヘッダー

URL は https://mcp.luw.ai/mcp、トランスポートは Streamable HTTP、認証はサインイン（MCP OAuth）です。サインインできないクライアントでは Authorization: Bearer YOUR_LUW_API_KEY ヘッダーを使います：

mcp.json

{
  "mcpServers": {
    "luw": {
      "url": "https://mcp.luw.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_LUW_API_KEY" }
    }
  }
}

サインインもヘッダー送信もできないクライアントでは、https://mcp.luw.ai/mcp?api_key=YOUR_LUW_API_KEY を使ってください。この URL を知っている人は誰でもあなたのクレジットを使えるため、外部に公開しないでください。

Windows：npx が見つからない場合は "command": "cmd", "args": ["/c", "npx", "-y", "@luw-ai/mcp"] を使ってください。LUW_TOOLSETS や LUW_WAIT_TIMEOUT_SECONDS などの環境変数を含む完全なガイドは、GitHub README にあります。

アシスタントにできること

21の MCPツールで、あらゆるデザイン業務に対応

各ツールは、アシスタントが自分で呼び出せる Luw.ai のモデルです。欲しい結果を伝えるだけで、アシスタントがツールを選び、オプションを設定し、複数の工程が必要なジョブではステップをつなげます。

Luw.ai の MCPツール：それぞれの機能と消費クレジット
ツール	できること	クレジット
`luw_interior_design`	お好みのスタイルで部屋をリデザイン、または空室に家具を配置してバーチャルステージング — 内装 AI	1
`luw_exterior_design`	ファサードや建物の外観をリデザイン — 外観 AI	1
`luw_sketch_to_render`	スケッチや図面をフォトリアルなレンダリングに — スケッチ AI	1
`luw_render`	3D、CAD、クレイのビューをフォトリアルなレンダリングに — Render AI	1
`luw_edit_image`	どんな画像もひと言で編集、2K または 4K で — マジックプロンプト AI	1
`luw_magic_wand`	マスク編集：置き換え、削除、素材の適用 — マジックワンド AI	1
`luw_landscape_design`	気候と日当たりに合わせた庭や屋外スペース	1
`luw_image_tools`	2×/4×/8× アップスケール（Enhance AI）、画像の拡張、部屋を空にする（家具を削除 AI）、SVG へのベクター化	1
`luw_background`	背景を削除、または生成したシーンに置き換え	1
`luw_segment`	オブジェクトマスク — すべてのオブジェクト、またはプロンプトで指定	1
`luw_generate_image`	Fluw AI によるテキストからの画像生成、または SVG ベクター	2
`luw_generate_pattern`	シームレスでタイル状に並べられるテクスチャとパターン	1
`luw_generate_video`	12種類のカメラモーションで、画像をシネマティックな動画に	10（Symphony 使用時は20）
`luw_image_to_3d`	写真からテクスチャ付きの 3Dモデル（GLB）を作成 — 3D AI	3（Symphony 使用時は8）
`luw_archigpt`	画像も読み取る AI 建築家アーキGPT とチャット — アーキGPT	約3,000語ごとに1
`luw_get_result`	時間のかかるジョブの結果を回収	無料
`luw_list_options`	使用できるスタイル、部屋・建物タイプ、カメラモーション、素材の一覧	無料
`luw_upload_file`	Luw.ai のストレージにファイルをアップロードして URL を取得	無料
`luw_run_model`	生の API パラメータで、任意の Luw.ai モデルを呼び出し	モデルにより異なる
`luw_personas`	ペルソナ：再利用できるスタイルアイデンティティ、学習用画像、スロット	無料
`luw_projects`	プロジェクト（ボード）、フォルダ、メディア	無料

エンタープライズのチームは、LUW_TOOLSETS で luw_team（クレジット、使用状況、メンバー、招待）も有効にできます。組み込みプロンプトは、対応するクライアントでスラッシュコマンドとして表示されます：redesign_room、stage_empty_room、sketch_to_render、product_shot。

接続したら、こんなふうに頼んでみましょう

「この寝室（~/Downloads/bedroom.jpg）をミッドセンチュリーモダンにリデザインして。3パターンで。」

「この物件写真は空室です。居心地のいい北欧風リビングにステージングして。」

「スケッチ plan-sketch.png を、ゴールデンアワーのフォトリアルなモダンヴィラとしてレンダリングして。」

「このキッチンの床をヘリンボーンのオークに変えて。」

「この部屋の家具をすべて取り除いて。」

「この椅子の写真を、日の差すギャラリーのテラゾーの床に置いて、広告用の画像にして。」

「このレンダリングを、ドローンで飛び回るフライスルー動画にして。」

「この3枚の写真から、アームチェアの 3Dモデルを作って。」

「シームレスな青いゼリージュタイルのテクスチャ、1024px。」

「この間取り図の風水を良くする方法をアーキGPT に聞いて。」

お使いの MCP スタックに、デザイン AI をプラス

AutoCAD、Revit、SketchUp、Rhino、Blender など、お使いのツールと組み合わせて使える

AIアシスタントは複数の MCPサーバーを同時に使えます。普段モデリングに使っているソフトウェアの MCPサーバーを Luw.ai と並べて接続しましょう。一方がモデルを操作し、Luw.ai がその書き出しをフォトリアルなレンダリング、編集、動画、3D アセットに変えます — すべて同じ会話の中で。

AutoCAD MCP + Luw.ai

アシスタントに AutoCAD から平面図、断面図、立面図を出力させ、luw_sketch_to_render で指定したスタイルのフォトリアルなレンダリングに仕上げます — アーキGPT にレイアウトをレビューさせることもできます。AutoCAD から AI レンダリングへの最短ルートです。

luw_sketch_to_renderluw_archigpt

Revit MCP + Luw.ai

Revit の MCPサーバー経由で 3D ビューやシートを書き出せば、luw_render がクライアントに見せられる画像に仕上げます。別の仕上げ材を試すときも、モデルを再レンダリングせずに luw_magic_wand で差し替えられます。

luw_renderluw_magic_wand

SketchUp MCP + Luw.ai

SketchUp のどんなビューポートも、数秒で AI レンダリング：luw_render がジオメトリを保ったまま光、素材、周辺環境を加え、luw_image_tools が結果を最大8倍までアップスケールします。

luw_renderluw_image_tools

Rhino & Grasshopper MCP + Luw.ai

Rhino のボリュームスタディが、luw_exterior_design でファサード案に、luw_render で周辺環境を含むフォトリアルなレンダリングに — 午前中だけで複数の方向性を検討できます。

luw_exterior_designluw_render

Archicad MCP + Luw.ai

Archicad の 3D ビューをプレゼン用のレンダリングにし、さらに luw_generate_video でクライアントとの打ち合わせ用のゆっくりしたフライスルー動画にします。

luw_renderluw_generate_video

3ds Max MCP + Luw.ai

クレイレンダリングをワンコールでフォトリアルに。さらに luw_generate_pattern で、マテリアルライブラリ用のシームレスでタイル状に並べられるテクスチャも作れます。

luw_renderluw_generate_pattern

Blender MCP + Luw.ai

Blender の MCPサーバーがあれば、アシスタントがシーンを構築・編集し、Luw.ai がビューポートをフォトリアルにレンダリング、シームレスなテクスチャを生成し、商品写真を Blender に読み込める GLB モデルに変換します — Blender でのインテリアデザインをエンドツーエンドで。

luw_renderluw_image_to_3dluw_generate_pattern

Unreal Engine & Unity MCP + Luw.ai

luw_image_to_3d で写真が GLB の小道具に、luw_generate_pattern で表面がタイル状のマテリアルに、luw_generate_image でブリーフがコンセプトフレームに — リアルタイムのシーンですぐに使えます。

luw_image_to_3dluw_generate_patternluw_generate_image

Photoshop MCP + Luw.ai

切り抜き、オブジェクトマスク、8倍アップスケールは Luw.ai で、仕上げは Photoshop で：時間のかかる作業は luw_background、luw_segment、luw_image_tools が引き受けます。

luw_backgroundluw_segmentluw_image_tools

Figma MCP + Luw.ai

luw_generate_image の SVG 形式で SVG イラストやアイコンを生成したり、手描きスケッチをベクター化したりして、Figma のフレームに配置できます。

luw_generate_imageluw_image_tools

Canva MCP + Luw.ai

Luw.ai で作ったステージング済みの部屋、生成背景の商品写真、物件ビジュアルを、Canva で SNS 投稿やチラシにレイアウト。

luw_interior_designluw_background

お使いのツールに MCPサーバーがない場合は？

画像を保存できるものなら何でも使えます：Vectorworks、Chief Architect、Lumion、D5 Render、Enscape、Twinmotion、手描きスケッチをスマホで撮った写真まで。ファイルをアシスタントに渡すか、Render AI の Web アプリを直接使ってください。

luw_upload_fileluw_render

試せる2サーバー連携プロンプト

プロンプト — Blender MCP と Luw.ai MCP を接続した状態

Using Blender, frame the living room from the doorway and save a viewport screenshot.
Then use Luw.ai to render it photoreal in Japandi style, give me 2 options,
and make a slow orbit video of the one I pick.

このページに記載の名称について。Luw.ai は独立した製品であり、Autodesk（AutoCAD、Revit、3ds Max）、Trimble（SketchUp）、Robert McNeel & Associates（Rhino、Grasshopper）、Graphisoft（Archicad）、Blender Foundation、Epic Games（Unreal Engine）、Unity Technologies、Adobe（Photoshop）、Figma、Canva、Anthropic（Claude）、OpenAI（ChatGPT、Codex）、Anysphere（Cursor）、Microsoft（VS Code、GitHub Copilot）、Google（Gemini）、その他ここに記載されたいかなる企業とも提携しておらず、承認や後援も受けていません。製品名は互換性を説明する目的でのみ使用しており、すべての商標はそれぞれの所有者に帰属します。サードパーティ製アプリケーションの MCPサーバーは、各ベンダーまたはそのコミュニティが公開しているものです。Luw.ai はそれらのアプリケーションを制御せず、アプリケーションが書き出す画像や 3D ファイルを扱います。

Luw.ai REST API v2

インテリアデザイン API、レンダリング API、画像から 3D API をひとつのエンドポイントで

すべての Luw.ai モデルは、同じ2つの呼び出しで使えます。モデル名と画像 URL を付けて /v2/generate にジョブを送ると processing_url が返ってくるので、出力が完成するまで /v2/results をポーリングします。

Terminal

curl -X POST https://api.luw.ai/v2/generate \
  -H "Authorization: Bearer YOUR_LUW_API_KEY" -H "Content-Type: application/json" \
  -d '{"model":"interior","image":"https://example.com/room.jpg","styles":"Japandi"}'
# → {"processing_url": "…"}; fetch the result:
curl -X POST https://api.luw.ai/v2/results \
  -H "Authorization: Bearer YOUR_LUW_API_KEY" -H "Content-Type: application/json" \
  -d '{"processing_url":"…"}'

JavaScript

const headers = { Authorization: "Bearer YOUR_LUW_API_KEY", "Content-Type": "application/json" };
const post = (path, body) =>
  fetch(`https://api.luw.ai/v2${path}`, { method: "POST", headers, body: JSON.stringify(body) }).then((r) => r.json());

const job = await post("/generate", { model: "interior", image: "https://example.com/room.jpg", styles: "Japandi" });
let res;
do {
  await new Promise((r) => setTimeout(r, 2000));
  res = await post("/results", { processing_url: job.processing_url });
} while (res.status !== false && !res.output);
console.log(res.output);

Python

import time, requests

H = {"Authorization": "Bearer YOUR_LUW_API_KEY"}
job = requests.post("https://api.luw.ai/v2/generate", headers=H,
                    json={"model": "interior", "image": "https://example.com/room.jpg", "styles": "Japandi"}).json()
while True:
    time.sleep(2)
    res = requests.post("https://api.luw.ai/v2/results", headers=H,
                        json={"processing_url": job["processing_url"]}).json()
    if res.get("output") or res.get("status") is False:
        break
print(res.get("output"))

同じリクエストを再試行するときに Idempotency-Key ヘッダーを送れば、二重に課金されることはありません。すべてのモデルのすべてのパラメータは API ドキュメントに掲載しています。

呼び出せるモデル

Luw.ai API のモデルと用途
model	製品	組み込み先…
`interior`	内装 AI	部屋のリデザイン向けインテリアデザイン API と、空室向けバーチャルステージング API — 物件ポータル、家具店、リフォームアプリに
`exterior`	外観 AI	ファサードの改修、外観イメージのプレビュー、住宅メーカーのコンフィギュレーター
`sketch`	スケッチ AI	描画アプリやデザインツール向けのスケッチ→レンダリング API
`render`	Render AI	CAD、BIM、3D ソフトウェアの書き出しに使える AI レンダリング API
`magicprompt`	マジックプロンプト AI	文章ひとつで編集できる機能、2K または 4K で
`magicwand`	マジックワンド AI	マスク内での素材の差し替えとオブジェクトの削除
`landscape`	ランドスケープ AI	地域と日当たりに合わせた庭・屋外スペースのデザイン
`enhance` · `expand`	Photo Enhance AI · 拡張 AI	画像アップスケール API（2×、4×、8×）とアウトペインティング
`removefurniture`	家具を削除 AI	家具のある部屋を空にして、ステージングし直す
`removebg` · `changebg`	背景を変更 AI	背景削除 API と、生成した商品シーン
`segment` · `segmentprompt`	Segment AI	自社の編集ツール向けのオブジェクトマスク
`fluw` · `fluwvector`	Fluw AI	SVG 出力にも対応したテキストから画像生成 API
`vector`	ベクター AI	写真や図面をきれいな SVG に
`pattern`	パターン AI	コンフィギュレーターや 3D エンジン向けのシームレステクスチャ
`video`	Video AI	シネマティックなカメラモーションに対応した画像から動画生成 API
`3dgen`	3DGen AI	テクスチャ付き GLB モデルを返す画像から 3D 生成 API
`archigpt`	アーキGPT	自社プロダクトの中で、建築とデザインの質問に回答
`puw`	Fluw ワークフロー	独自のマルチステップパイプラインを単一のエンドポイントに — 詳しくは下記

ワークフロー API

ノーコードの AI ワークフローを、独自の API エンドポイントに

Fluw のキャンバス上でモデルをつなげ（たとえば部屋を空にし、3つのスタイルでステージングし、それぞれを 4K にアップスケール）、変更したい入力を変数としてマークします。「Use as API」で、パイプライン全体をひとつのエンドポイントにできます。

"model": "puw" とワークフローの pid を指定して呼び出します。公開されるのは変数だけで、それ以外にはキャンバスに保存された値が使われます。
進捗では実行中のステップがわかり、完了したジョブは最後のステップだけでなく、すべてのステップの出力を返します。
配列を渡せばバッチ実行できます：有料プランでは1リクエストあたり最大40件（無料プランは5件）、各アイテムは個別に再試行できます。

ワークフローをバッチで実行

curl -X POST https://api.luw.ai/v2/generate \
  -H "Authorization: Bearer YOUR_LUW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "puw",
  "pid": "YOUR_WORKFLOW_ID",
  "inputs": {
    "dynamicInputs": [
      {
        "id": "room",
        "label": "Room photo",
        "value": ["https://example.com/a.jpg", "https://example.com/b.jpg"]
      }
    ]
  }
}'

ホワイトラベル & パートナー

自社ブランドで提供する、ホワイトラベルの AI インテリアデザイン、レンダリング、バーチャルステージング

プロップテック企業、家具小売、CAD ベンダー、エージェンシーが、自社プロダクトに Luw.ai を組み込んで提供しています。顧客が目にするのはあなたのブランド。生成は Luw.ai が担います。

すべての出力にあなたのブランドを

E3 とカスタムプランでは、レンダリングの出力から Luw.ai のブランド表記が削除され、自社のロゴを追加できます。チームプランには、ブランディングと再販権を含む拡張ライセンスが付属します。

当社のエンジンで独自のアプリを構築

キッチンプランナー、物件掲載ツール、家具店向けのルームビジュアライザー、ニッチなデザインアプリ：インターフェースを作り、API を呼び出し、顧客との関係は自社で持ち続けられます。ホワイトラベルのインターフェースか、API のみか、お選びいただけます。

パートナー・リセラープログラム

地域のディストリビューターやリセラーは、開設したアカウントから継続的な収益を得られます。担当地域、価格、サポートは書面で合意します。開発者には、サンドボックスアカウント、ロードマップの共有、チームへの直通窓口を提供します。

Luw.ai API を活用している業種

不動産ポータル

すべての空室物件写真にバーチャルステージング API を。入居中の物件には家具の削除も。

家具 & インテリア小売

購入者自身の部屋に、生成したライフスタイル背景に、あるいは 3Dモデルとして商品を見せられます。

CAD & BIM ソフトウェア

現在のビューをレンダリング API に送り、フォトリアルな画像を返す AI レンダリングボタンを追加できます。

エージェンシー & スタジオ

クライアントワークを自社ブランドのツールで。チームで共有するレンダー枠と、ひとつにまとまった請求書で。

パートナーに応募チームプランを比較

料金

席数ではなく、デザインごとに支払う

MCPサーバーと API は、Web アプリと同じ Luw.ai クレジットを、解像度・ウォーターマーク・モデルについての同じプランルールのもとで消費します。接続は無料で、新規アカウントにはお試し用の無料クレジットが付きます。

MCPツール呼び出しごとのクレジット
呼び出し	クレジット
インテリア、エクステリア、ランドスケープ、スケッチ、レンダリング、編集、マスク、アップスケール、背景、パターン	1
テキストから画像または SVG	2
画像から 3D（GLB）	3 · Symphony 使用時は8
画像から動画	10 · Symphony 使用時は20
アーキGPT	約3,000語ごとに1
結果、オプション、アップロード、プロジェクト	無料

バリエーションは、1件ごとに1回の生成として課金されます。

Luw.ai のプラン別レンダー単価
プラン	月間レンダー数	1レンダーあたり
無料	毎日2クレジット	$0 · 512px、ウォーターマーク付き
Pro	200	$0.10
Ultra · API アクセス	1,200	$0.07
E1 · Studio	5,000	$0.06
E3 · ホワイトラベル	20,000	$0.05
カスタム	無制限	ボリューム価格、SLA

有料プランには、商用ライセンスとウォーターマークなしの 4K 出力が含まれます。すべてのプランとトークンパックは料金ページでご確認ください。

MCPサーバーと API の違い

どちらが必要ですか？

多くのチームは両方を使っています：デザイナーは MCPサーバーで作業し、プロダクトは API を呼び出します。

Luw.ai MCPサーバーと Luw.ai REST API の比較
比較項目	MCPサーバー	REST API
呼び出す主体	AIアシスタントが、あなたの代わりに	あなたのコード
依頼の方法	チャットで、普段の言葉で	JSON：モデル名とパラメータ
セットアップ	URL を貼り付けてサインイン、または npx コマンドひとつ	APIキーと2回の HTTP 呼び出し
ステップの連結	アシスタントが判断し、ツールをつなげる	自分でオーケストレーションするか、Fluw ワークフローを実行
ローカルファイル	可能（ローカルサーバー使用時）	画像の URL を送信
ホワイトラベル	—	可能（E3・カスタムプラン）
課金	どちらも同じクレジット、同じキー

安心してキーを任せられる設計

ステートレスなホスティング

ホスト型サーバーは何も保存しません。キーはリクエストごとに、Luw.ai API へ直接渡されます。

コピー＆ペーストではなく、サインイン

PKCE 付きの MCP OAuth で、クライアントには通常の APIキーが渡されます。このキーはいつでも削除できます。

オープンソース

サーバーは MIT ライセンスで GitHub に公開され、npm で配布、MCP Registry に ai.luw/mcp として登録されています。

セルフホスト

npx -y @luw-ai/mcp --http、または同梱の Dockerfile を、自社のインフラで実行できます。

Luw.ai API & MCP — よくある質問

MCPサーバーとは何ですか？Luw.ai MCPサーバーでは何ができますか？

MCP（Model Context Protocol）は、Claude、ChatGPT、Cursor などの AIアシスタントが外部ツールを呼び出せるようにするオープン標準です。Luw.ai MCPサーバーは、内装・外観・ランドスケープデザイン、バーチャルステージング、スケッチや CAD からのレンダリング、画像編集、動画、画像から 3D まで、21のデザインツールを提供します。普段の言葉でデザインを頼めば、結果がチャットに表示されます。

Luw.ai MCPサーバーは無料ですか？

接続は無料で、サーバーはオープンソースです。生成ごとに Luw.ai クレジットを消費し（ほとんどのデザインは1クレジット）、新規アカウントにはお試し用の無料クレジットが付きます。無料プランでは毎日2クレジットが追加され、512px・ウォーターマーク付きで出力されます。有料プランなら、ウォーターマークなしの 4K です。

Luw.ai を Claude に追加するには？

claude.ai または Claude Desktop で「設定」→「コネクタ」を開き、「カスタムコネクタを追加」を選んで次の URL を貼り付けます: https://mcp.luw.ai/mcp, その後「接続」をクリックして Luw.ai にサインインします。Claude Code では claude mcp add --transport http luw https://mcp.luw.ai/mcp --scope user を実行し、/mcp と入力してサインインします。

Luw.ai を ChatGPT に接続するには？

ChatGPT で「設定」→「アプリとコネクター」→「詳細設定」を開き、開発者モードをオンにします。「作成」をクリックして URL に https://mcp.luw.ai/mcp を入力し、OAuth を選んで Luw.ai にサインインします。

対応している AIアシスタントとコードエディタは？

Claude（claude.ai、Claude Desktop、モバイル、Claude Code）、ChatGPT、Cursor、VS Code（GitHub Copilot）、Windsurf、OpenAI Codex CLI、Gemini CLI、Kiro には、手順付きのセットアップガイドがあります。Streamable HTTP 経由のリモート MCP、またはローカルの stdio サーバーに対応したその他のクライアントでも動作します。

Claude Code や Cursor で、MCPサーバーを使って画像を生成できますか？

はい。Luw.ai を接続すれば、luw_generate_image が Fluw AI でテキストから画像や SVG ベクターを生成し、ほかのツールで画像の編集、アップスケール、レンダリング、アニメーション化ができます。ローカルサーバーを実行すれば、アシスタントがプロジェクトフォルダ内の画像ファイルを直接扱えます。

MCPサーバーを使うには APIキーが必要ですか？

ホスト型サーバーなら不要です。MCP のサインインに対応したクライアントでは Luw.ai にログインでき、サインイン時にキーが自動で作成されます。ローカルサーバーや、サインインできないクライアントでは、API ページ（app.luw.ai/dashboard/api）で作成したキーを使います。

MCPサーバーは、パソコン上の画像を使えますか？

ローカルサーバーなら使えます。~/Desktop/room.jpg のようなパスを渡すと、ファイルが一時ファイルとしてアップロードされ、12時間後に削除されます。ホスト型サーバーはディスクを読み取れないため、画像の URL を渡すか、画像を受け渡しできるクライアントで画像を添付してください。

Luw.ai は AutoCAD、Revit、SketchUp、Blender と連携できますか？

はい、各ソフトが書き出すデータを通じて連携します。お使いの AutoCAD、Revit、SketchUp、Rhino、Archicad、3ds Max、Blender の MCPサーバーを Luw.ai と並べて接続すれば、アシスタントがビューポート、図面、スクリーンショットを Luw.ai に渡し、フォトリアルなレンダリング、編集、動画、3Dモデルを作成できます。Luw.ai はこれらのアプリケーションを制御せず、各メーカーとも提携していません。

インテリアデザイン API やバーチャルステージング API はありますか？

はい。Luw.ai REST API の interior モデルは、部屋の写真を選んだスタイルでリデザインし、空室に家具を配置するバーチャルステージングも行えます。同じ API で、外観・ランドスケープデザイン、スケッチや CAD からのレンダリング、アップスケール、背景削除、画像から動画、画像から 3D までカバーします。

MCPサーバーと API、どちらを使うべきですか？

人が AIアシスタントを通じて作業し、普段の言葉で依頼したいなら MCPサーバーを。Web サイト、アプリ、バッチパイプラインなど、自社のソフトウェアから Luw.ai を呼び出すなら REST API を使ってください。どちらも同じ APIキーとクレジットを使うので、両方を使うチームも多くあります。

Luw.ai をホワイトラベルで使えますか？

はい。E3 とカスタムプランでは出力から Luw.ai のブランド表記が削除され、自社のロゴを追加できます。チームプランには、ブランディングと再販権を含む拡張ライセンスが付属します。独自のプロダクトを構築したい場合や、ご自身の市場で Luw.ai を再販したい場合は、app.luw.ai/partners からお申し込みください。

リクエストが失敗して再試行した場合、二重に課金されますか？

いいえ。MCPサーバーはすべての生成に Idempotency-Key を付けて送信するため、再試行しても新たな課金は発生せず、元のジョブが返されます。独自の API 呼び出しでも、リクエストを再試行するときに Idempotency-Key ヘッダーを送れば同じように動作します。

Luw.ai MCPサーバーはオープンソースですか？自分でホストできますか？

はい。サーバーは MIT ライセンスで GitHub の Luvi-io/luw-mcp に公開され、npm で @luw-ai/mcp として配布されています。npx -y @luw-ai/mcp --http、または同梱の Dockerfile を実行すれば、Streamable HTTP エンドポイントをセルフホストできます。サーバーはステートレスで、各リクエストがそれぞれのキーを持ちます。

画像を商用利用できますか？

有料プランなら可能です。Pro 以上には商用ライセンスが含まれ、チームプランでは拡張ライセンスが追加されます。無料プランで作成した出力にはウォーターマークが入り、個人利用に限られます。