MuAPI Official Blender Extension

AI-powered 3D asset generation directly inside Blender using MuAPI.

---

🚀 Quick Start

1. Download or package the addon folder into a .zip file (see Installation).
2. Install the extension in Blender (supports Blender 4.2 and up on Windows, macOS, and Linux).
3. Set your MuAPI API Key / Token in the addon preferences (defaults to production URL https://api.muapi.ai).
4. Press N in the 3D Viewport to open the sidebar and click the MuAPI tab.
5. Pick a model, write a prompt or select input images, and click Generate 3D Model.

Jobs run asynchronously in the background. You can keep working in Blender while tasks process, and monitor progress in the Active Jobs sub-panel. Once finished, files are downloaded and imported automatically at your 3D cursor.

---

📦 3D Generation Workflows

Generate textured 3D models from text or image prompts and import them directly as GLB models.

Text-to-3D

Generate a textured 3D mesh from a text description.

Model / Endpoint	Description
Tripo P1 Text-to-3D	Low-poly friendly, 48–20k face budget.
Tripo H3.1 Text-to-3D	High-quality text-to-3D with quad-topology options.
Meshy v6 Text-to-3D	High-detail game-ready assets from text prompts.

Image-to-3D

Condition 3D generation on a static Blender image texture.

Model / Endpoint	Description
Tripo P1 Image-to-3D	Turns single images into 3D models.
Tripo H3.1 Image-to-3D	High-fidelity image-to-3D with quad topology option.
Meshy v6 Image-to-3D	Turns any 2D illustration or render into a 3D model.

Multiview-to-3D

Create a 3D mesh by supplying multiple camera angles of the same object.

Model / Endpoint	Description
Tripo H3.1 Multiview-to-3D	Supports 2 to 4 input images for precise geometry.
Meshy v6 Multi-Image-to-3D	Generates consistent geometry from multi-view inputs.

---

🔧 Preferences

In Edit → Preferences → Get Extensions → MuAPI — AI Studio:

• API Key — Your secure MuAPI token (required).
• Server URL — Server address (defaults to production https://api.muapi.ai).
• Output Directory — Location where downloaded GLB files are saved.
• Auto-Import — Toggle auto-importing completed assets into the active scene.

---

🛠️ Requirements

• Blender 4.2+ (supports 4.x and 5.x).
• A valid MuAPI API Key / Token.

---

📥 Installation

Open your Command Prompt (not PowerShell) and package the extension folder:

# Navigate to your workspace containing the folder
tar -a -c -f muapi_blender_extension.zip muapi_blender_extension

Then, inside Blender:

1. Go to Edit → Preferences... → Get Extensions.
2. Click the arrow/menu icon in the top-right and choose Install from Disk...
3. Select muapi_blender_extension.zip.
4. Enable the addon, allow Online Access in the top prompt, and enter your API Key.

---

📂 Architecture

controllers/          Blender operators and logic wrappers
  __init__.py         Operator exports
  operators.py        MUAPI_OT_Generate3DModel and other operators
models/               Request schema templates
  __init__.py         Model catalog exports
  base.py             MuapiModel base structures
  model_3d.py         Tripo and Meshy 3D API parameters
  image_models.py     Flux Dev/Schnell/Kontext parameter schemas (hidden)
  video_models.py     Veo 3.1 parameter schemas (hidden)
  audio_models.py     MMAudio parameter schemas (hidden)
  utility_models.py   Upscale, BG Remover, Face Swap schemas (hidden)
__init__.py           Addon class registration and timer setups
app.py                Side panel layout drawing for View3D & VSE
job_queue.py          Async worker thread and status polling loops
preferences.py        Addon options (API key, server path, outputs)
utils.py              S3 uploads and urllib requests engine

---

📄 License

GPL-3.0-or-later