Meltflex - Ai Room Design

MeltFlex AI スキル

MeltFlex AI を利用して、フォトリアルな屋内外のデザインと 3D を実現する AI エージェントスキルです。1 枚の写真から、部屋のスタイル変更、実物の家具の配置、床・壁・階段・ドア・窓の差し替え、キッチン・バスルーム・ファサード・庭のリデザイン、3D の下書きの写真化ができます。さらに、映画のようなウォークスルー動画、2D 間取り図 → 3D モデルまたはレンダリング済み 3D 画像、家具の写真 → GLB 3D モデル、写真 → 探索可能な 3D ワールド も作成できます。Claude Code、 Hermes、Cursor、Codex、Cline、および Markdown ベースのスキルを読み込むか MCP に対応するその他の AI エージェントで利用できます。

各ユーザーは自身の MeltFlex API キーで認証します。生成ごとに、そのユーザーのアカウントクレジットが請求されます。スキルは公開されている MeltFlex API を直接呼び出すため、追加のインストールは不要です。

_{インテリアのリデザイン · 素材を使った床のスタイル変更 · 庭のデザイン — 1 枚の写真から作成できる 16 種類の画像モードの一例です。}

_{家具の写真 → 3D モデル · 部屋のレンダリング → 探索可能な 3D ワールド · 2D 間取り図 → 3D モデル。/api/v1/furniture-3d、/api/v1/world、/api/v1/floorplan-to-3d の実際の出力です。}

インストール

いずれか 1 つを選択してください。どの方法でも、エージェント用のスキルがセットアップされます。

npx skills — 推奨、複数のエージェントに対応

npx skills add MeltFlexDevs/skills

GitHub CLI（v2.90 以降）

gh skill install MeltFlexDevs/skills

Claude Code マーケットプレイス

Claude Code 内で実行します。

/plugin marketplace add MeltFlexDevs/skills
/plugin install meltflex@meltflex

セットアップスクリプト

汎用の代替方法：

git clone --depth 1 https://github.com/MeltFlexDevs/skills.git
cd skills
./setup

その他の方法は INSTALL.md をご覧ください。エージェントからのインストール（エージェントに貼り付けてください）：INSTALL_FOR_AGENTS.md。Cline など MCP 設定に対応するエージェントについては、llms-install.md をご覧ください。

認証

有効なサブスクリプション（有料プランならどれでも）が必要です。サブスクリプションがないと、キーは機能しません。https://www.meltflexai.com/settings で登録した後、アカウント設定 → Profile の API Key を開き、Generate API Key を選択します（キーは一度だけ表示されるため、コピーしてください）。

次に、キーを公開します。

export MELTFLEX_API_KEY="mf_sk_xxxxxxxxxxxx"

MCP サーバーまたは CLI を使用する場合は、コピー＆ペーストを省略して、ブラウザーからサインインできます。npx -y meltflex-mcp auth login を実行すると https://www.meltflexai.com/cli/authorize が開き、サインイン済みのセッションからキーが発行され、~/.meltflex/config.json に保存されます（chmod 600）。

スキル

スキル	呼び出し	説明
meltflex-design	/meltflex:design	部屋、ファサード、庭のスタイル変更、床・壁・階段・ドア・窓の差し替え、キッチンやバスルームのリデザイン、レイアウトの改善、3D 下書きの写真化ができます。品質レベル、領域編集、一括処理に対応したプロンプト主導の16種類のモードに加え、API 経由の動画ウォークスルーにも対応しています。
meltflex-furniture	/meltflex:furniture	実在する特定の家具・装飾品を部屋の写真に配置し、色、素材、比率を正確に再現します（参照アイテムは最大10点）。
meltflex-3d	/meltflex:3d	3D 出力：家具の写真から GLB モデル、2D 間取り図から GLB モデルまたはレンダリング済み3D画像、部屋の写真から探索可能な3Dワールド（スプラット＋ホスト型ビューアー）を生成します。時間のかかるビルド処理のポーリングにも対応しています。
meltflex-embed	/meltflex:embed	iframe としてデザインツールを独自のウェブサイトに設置できます。訪問者はアカウントなしで部屋のデザインや、ショップの商品を部屋に配置できます。HTML、React、Vue、Shopify、WordPress へのコードの導入と、空白フレームの修正に対応しています。API キーは不要です。

画像スキルは単体で完結します。部屋の写真を入力すると、フォトリアルなリデザイン画像が出力されます。画像1枚あたり10クレジットです（失敗時は自動返金）。

画像モード

meltflex-design — 16種類のモードがあり、それぞれ同じ POST /api/v1/generate エンドポイントを、モードに合わせて調整されたプロンプトとともに使用します。

モード	用途
restyle	部屋のスタイルやテーマを変更します
virtual_staging	空室に家具を配置します
layout_boost	既存の家具をよりよいレイアウトに配置し直します
declutter	空間を片付け、個人の持ち物を取り除きます
exterior	建物のファサード／住宅の外観
garden	造園や屋外デザイン
wall_texture	壁の素材や仕上げを変更します
floor_restyle	床材を変更します
stairs	階段の位置を変えずにスタイルを変更します
doors	室内ドアを差し替えます
windows	窓枠／窓ガラスを差し替えます
kitchen	キッチン全体をリデザインします
bathroom	バスルーム全体をリデザインします
photo_to_render	3D 下書き／SketchUp の画像を写真に変換します
seasonal	時刻／季節／照明のバリエーション
region_edit	1つの領域だけを変更します。単色の赤で塗る場合は mask: true を送信します

すべての画像呼び出しで指定できるオプションフィールド：resolution（512／1K／2K）、designLevel（lite −2 cr・quick・pro +5 cr）、variations（呼び出しごとに1～3、画像ごとに課金）、最大10個の referenceImageUrls。

動画と3D

同じキーで、さらに5種類の出力を利用できます。3D 生成のうち3種類は完了まで数分かかる場合があります。リクエスト中に完了しない場合は HTTP 202 + ポーリング URL を返し、ポーリング方法は /meltflex:3d で確認できます。

出力	エンドポイント	クレジット	時間	MCP ツール · CLI
シネマティックなウォークスルー動画（MP4、Veo 3.1）	POST /api/v1/video	100（4s） / 150（8s）	約1分	generate_video · meltflex video
間取り図 → レンダリング済み3D画像（PNG）	POST /api/v1/floorplan-to-3d output: "render"	10	約20秒	REST のみ
間取り図 → GLB 3D モデル	POST /api/v1/floorplan-to-3d output: "model"	100	約3分	floorplan_to_3d · meltflex floorplan
家具の写真 → GLB 3D モデル（+ USDZ/FBX/OBJ）	POST /api/v1/furniture-3d	75	2～3分	furniture_to_3d · meltflex furniture
写真 → 探索可能な3Dワールド（.spz + ビューアーリンク）	POST /api/v1/world	30（draft） / 200（hd）	約1分 / 約5分	generate_world · meltflex world

レスポンスボディと three.js / Spark ローダーのスニペットを含む完全なリファレンス：https://www.meltflexai.com/api。

クイックリファレンス

やりたいこと	スキル	備考
写真から部屋のスタイルを変更する	meltflex-design	モードを選び、具体的なプロンプトを記述します
空室に家具を配置する	meltflex-design	virtual_staging モード
特定の ソファ／ベッド／テーブルを配置する	meltflex-furniture	商品画像を参照画像として渡します
家の外観や庭をデザインし直す	meltflex-design	exterior / garden モード
床材や壁面の仕上げを変更する	meltflex-design	floor_restyle / wall_texture（素材を参照画像として添付します）
階段、ドア、窓のスタイルを変更する	meltflex-design	stairs / doors / windows モード
キッチンやバスルームをデザインし直す	meltflex-design	kitchen / bathroom モード
3Dの下書きを写真に変換する	meltflex-design	photo_to_render モード
指定した領域だけを変更する	meltflex-design	region_edit — 赤く塗り、mask: true を指定します
より鮮明な出力／複数の候補を得る	meltflex-design	resolution: "2K"、designLevel: "pro"、variations: 3
シネマティックなウォークスルー動画	meltflex-design	POST /api/v1/video（100～150クレジット）
家具の3Dモデル	meltflex-3d	POST /api/v1/furniture-3d（75クレジット）
2D間取り図 → 3Dモデル／3D画像	meltflex-3d	POST /api/v1/floorplan-to-3d（100 / 10クレジット）
3Dで部屋を歩き回る	meltflex-3d	POST /api/v1/world（draft 30 / hd 200）
クレジット残高を確認する	—	meltflex credits（CLI）または MCP の check_credits ツール

ウェブサイトに埋め込む

_{Kondelaの家具ショップで公開中：買い物客はショップ独自のページで、部屋の写真にショップ独自の商品を配置できます。}

API キーもバックエンドも不要です。ウェブサイト埋め込みビルダーで埋め込みを作成し（ドメイン、ロゴ、色、言語、ショップの場合は商品フィードを設定）、iframe を1つ貼り付けるだけです。訪問者はアカウントを作成せずにページ上で部屋をデザインできます。デザイン1件につき、アカウントから10クレジットが使われます。どのアカウントでもコードを取得でき、デザインを10件無料で利用できます。それ以降はエンタープライズプランで利用できます。

<iframe
  src="https://widget.meltflexai.com/YOUR_EMBED_ID"
  title="AI Interior Design by MeltFlex"
  width="100%"
  height="720"
  style="border:0;border-radius:12px;max-width:100%;"
  allow="clipboard-write"
  loading="lazy"
></iframe>

ショップの商品ページでは、?product=<product page address> を追加すると、その商品が選択された状態でツールが開きます。/meltflex:embed はコードをプロジェクトに導入し（HTML、React / Next.js、Vue、Shopify、WordPress）、サイトにコンテンツセキュリティポリシーがある場合は frame-src ルールを設定し、空のフレームを使って手順を案内します。ガイド：https://www.meltflexai.com/api#embed。

MCP サーバーでの使用

スクリプトによる API 呼び出しよりもツール呼び出しを優先するエージェントは、meltflex-mcp サーバー（npm、stdio）を実行できます。generate_interior、generate_video、floorplan_to_3d、furniture_to_3d、generate_world、check_credits の 6 つのツールを提供し、ポーリングとファイルのディスクへの保存を処理します。

npx -y meltflex-mcp auth login              # or: npx -y meltflex-mcp auth mf_sk_xxxxxxxx
claude mcp add meltflex -- npx -y meltflex-mcp

どの MCP クライアントでも同じ形式（command: npx、args: ["-y", "meltflex-mcp"]、任意の env.MELTFLEX_API_KEY）で使用できます。同じパッケージはターミナル CLI としても使えます：meltflex generate | video | floorplan | furniture | world | credits。Claude Desktop 拡張機能バンドルは mcpb/ にあります。

Hermes

Hermes（Nous Research）は MCP に対応しているため、同じサーバーを通じて MeltFlex を実行できます。

カタログから（Hermes カタログにマージされた後）：

hermes mcp install meltflex

手動で設定する場合 — まず一度サインインしてから、サーバーを ~/.hermes/config.yaml に追加します：

npx -y meltflex-mcp auth login

mcp_servers:
  meltflex:
    command: npx
    args: ["-y", "meltflex-mcp"]

hermes chat を開始する（またはセッション中に /reload-mcp を実行する）と、6 つの MeltFlex ツールが読み込まれます。詳しいガイド：https://www.meltflexai.com/mcp。

さらに詳しく

• API ドキュメント： https://www.meltflexai.com/api
• CLI： https://www.meltflexai.com/cli — ターミナルから meltflex generate を実行
• MCP サーバー： https://www.meltflexai.com/mcp — npx -y meltflex-mcp
• クックブック： COOKBOOK.md · 変更履歴： CHANGELOG.md

セキュリティ

スキルにキーが含まれることはありません。各ユーザーが自身の mf_sk_ キーを MELTFLEX_API_KEY 経由で指定し、生成にはそのユーザー自身のクレジットが使用されます。クレジット、認証、レート制限はすべてサーバー側で適用されます。キーをコミットしないでください。設定からいつでも無効化できます。

ライセンス

MIT — LICENSE を参照してください。コントリビューションを歓迎します — CONTRIBUTING.md を参照してください。