multi-image-to-3d

複数画像から3Dモデルを作成するBlenderスキル

Meshy AIのMulti-Image to 3D APIを使用して、同じオブジェクトを異なる角度から撮影した1～4枚の写真をテクスチャ付き3Dモデルに変換し、アクティブなBlenderシーンにインポートします。角度が多いほど、ジオメトリとテクスチャの精度が向上します。

使用する場面

次の場合にこのスキルを使用します：

• ユーザーが同じオブジェクトの写真を複数枚提供し、3Dモデルを作成したい場合
• ユーザーが「複数の角度から3D化」「これらの画像を3Dに変換」「この写真から3Dモデルを作成」と依頼した場合
• ユーザーが単一画像から作成する場合よりも精度の高い3Dモデルを求めている場合
• ユーザーが製品、キャラクター、オブジェクトの正面、背面、側面の写真を持っている場合

前提条件

• Meshy API Key：メモリから取得します（reference_meshy_api.md）
• Blender MCP：接続されている必要があります（blender-mcpアドオンがポート9876で実行中）
• 画像：ローカルファイルパス（.jpg、.jpeg、.png）または誰でもアクセスできるURLを1～4個
• 同じオブジェクト：すべての画像に同じオブジェクトを異なる角度から写す必要があります

フロー

ステップ1：画像を準備する

ローカルファイルごとに、base64エンコードして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}")

ステップ2：複数画像から3Dを生成するタスクを作成する

base64文字列はCLI引数に収まらないため、ペイロードをJSONファイルに書き込みます：

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)

次に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

レスポンス：{"result": "<task_id>"}

ステップ3：完了を確認する

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

15秒ごとに確認します。statusを確認してください：

• PENDING — キューに登録済み（キュー内の位置はpreceding_tasksで確認）
• IN_PROGRESS — 生成中（進捗率はprogressで確認）
• SUCCEEDED — 完了。model_urls.glbからダウンロードします
• FAILED — task_error.messageを確認します

ステップ4：GLBをダウンロードする

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

ステップ5：Blenderにインポートする

Blender MCPのexecute_blender_codeツールを使用します：

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'

設定オプション

オプション	デフォルト	説明
ai_model	meshy-6	meshy-5、meshy-6、またはlatest
topology	triangle	quadまたはtriangleメッシュ
target_polycount	30000	100～300,000ポリゴン
enable_pbr	true	メタリック／粗さ／法線マップ
symmetry_mode	auto	off、auto、またはon
pose_mode	""	a-pose、t-pose、または空
should_texture	true	テクスチャを生成します
should_remesh	false	目標ポリゴン数／トポロジーに合わせてリメッシュします
remove_lighting	true	照明が焼き込まれていないクリーンなテクスチャを作成します
image_enhancement	true	入力画像を最適化します
target_formats	all	配列：glb、obj、fbx、stl、usdz、3mf

最良の結果を得るためのヒント

• 異なる角度：正面、背面、左側面、右側面が最適です
• 一貫した照明：すべての写真で同じ照明条件にします
• シンプルな背景：無地または白の背景が適しています
• 同じオブジェクト：すべての画像に必ず同じオブジェクトを写してください
• 2～4枚の画像：角度が多いほど精度が向上しますが、4枚を超えると効果は徐々に小さくなります

エラー処理

• 400：画像数が無効（1～4枚である必要があります）、形式が不正、またはURLにアクセスできません
• 402：Meshyクレジットが不足しています
• 429：レート制限です。待ってから再試行してください
• FAILEDステータス：task_error.messageをユーザーに伝えてください