multi-image-to-3d

name	multi-image-to-3d
description	Convert multiple photos (1-4 angles) of the same object into a high-accuracy 3D model using Meshy API and import into Blender.

Multi-Image to 3D Blender Skill

Converts 1-4 photos of the same object (from different angles) into a textured 3D model using Meshy AI's Multi-Image to 3D API, then imports it into the active Blender scene. More angles = more accurate geometry and textures.

When to Use

Trigger this skill when:

• User provides multiple photos of the same object and wants a 3D model
• User says "multi-angle 3D", "convert these images to 3D", "make a 3D model from these photos"
• User wants a more accurate 3D model than single-image can provide
• User has front/back/side shots of a product, character, or object

Prerequisites

• Meshy API Key: Retrieved from memory (reference_meshy_api.md)
• Blender MCP: Must be connected (blender-mcp addon running on port 9876)
• Images: 1-4 local file paths (.jpg, .jpeg, .png) or publicly accessible URLs
• Same object: All images must depict the same object from different angles

Flow

Step 1: Prepare the Images

For each local file, base64 encode it into a data URI:

import base64, json

image_paths = ["front.png", "back.png", "side.png"]  # user-provided paths
image_urls = []

for path in image_paths:
    with open(path, 'rb') as f:
        b64 = base64.b64encode(f.read()).decode()
    ext = path.rsplit('.', 1)[-1].lower()
    mime = 'image/jpeg' if ext in ('jpg', 'jpeg') else 'image/png'
    image_urls.append(f"data:{mime};base64,{b64}")

Step 2: Create Multi-Image-to-3D Task

Write payload to a JSON file (base64 strings are too large for CLI args):

payload = {
    "image_urls": image_urls,  # array of 1-4 data URIs or public URLs
    "ai_model": "meshy-6",
    "enable_pbr": True,
    "should_texture": True,
    "target_formats": ["glb"]
}

with open("output/request.json", "w") as f:
    json.dump(payload, f)

Then POST:

curl -s https://api.meshy.ai/openapi/v1/multi-image-to-3d \
  -X POST \
  -H "Authorization: Bearer ${MESHY_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d @output/request.json

Response: {"result": "<task_id>"}

Step 3: Poll for Completion

curl -s https://api.meshy.ai/openapi/v1/multi-image-to-3d/<task_id> \
  -H "Authorization: Bearer ${MESHY_API_KEY}"

Poll every 15 seconds. Check status:

• PENDING — queued (check preceding_tasks for queue position)
• IN_PROGRESS — generating (check progress for %)
• SUCCEEDED — done, download from model_urls.glb
• FAILED — check task_error.message

Step 4: Download the GLB

curl -L -o "output/<filename>.glb" "<model_urls.glb>"

Step 5: Import into Blender

Use the Blender MCP execute_blender_code tool:

import bpy

# Clear scene (optional)
for obj in bpy.data.objects:
    bpy.data.objects.remove(obj, do_unlink=True)

# Import GLB
bpy.ops.import_scene.gltf(filepath="<path_to_glb>")

# Frame imported object
bpy.ops.object.select_all(action='SELECT')

# Add basic lighting
import math
from mathutils import Vector, Euler
bpy.ops.object.light_add(type='AREA', location=(2, -2, 3))
key = bpy.context.active_object
key.data.energy = 500
key.data.size = 3

# Set viewport to material preview
for area in bpy.context.screen.areas:
    if area.type == 'VIEW_3D':
        for space in area.spaces:
            if space.type == 'VIEW_3D':
                space.shading.type = 'MATERIAL'

Configuration Options

Option	Default	Description
ai_model	meshy-6	meshy-5, meshy-6, or latest
topology	triangle	quad or triangle mesh
target_polycount	30000	100–300,000 polygons
enable_pbr	true	Metallic/roughness/normal maps
symmetry_mode	auto	off, auto, or on
pose_mode	""	a-pose, t-pose, or empty
should_texture	true	Generate textures
should_remesh	false	Remesh to target polycount/topology
remove_lighting	true	Clean textures without baked lighting
image_enhancement	true	Optimize input images
target_formats	all	Array: glb, obj, fbx, stl, usdz, 3mf

Tips for Best Results

• Different angles: Front, back, left side, right side work best
• Consistent lighting: Same lighting conditions across all photos
• Clean background: Plain/white backgrounds help
• Same object: All images MUST be the same object
• 2-4 images: More angles = better accuracy, but diminishing returns past 4

Error Handling

• 400: Invalid image count (must be 1-4), bad format, unreachable URL
• 402: Insufficient Meshy credits
• 429: Rate limited — wait and retry
• FAILED status: Report task_error.message to user