AGENT SKILL

image-to-3d

Convert a photo into a 3D model using Meshy API and import it into Blender via MCP.

License 许可
MIT
所属仓库
siddu1004/SFP
最近更新
2026-11-09
Stars
★ 5
Forks
0

01 前言 Front Matter

name
image-to-3d
description
Convert a photo into a 3D model using Meshy API and import it into Blender via MCP.

03 SKILL.md 正文

Image to 3D Blender Skill

Converts a user-provided photo into a textured 3D model using the Meshy AI API, then imports it into the active Blender scene.

When to Use

Trigger this skill when:

  • User wants to turn a photo/image into a 3D model
  • User says "make this 3D", "convert to 3D", "3D model from image"
  • User provides an image and wants it in Blender as a 3D object

Prerequisites

  • Meshy API Key: Stored in environment variable MESHY_API_KEY or passed directly
  • Blender MCP: Must be connected (blender-mcp addon running on port 9876)
  • Image: Local file path (.jpg, .jpeg, .png) or publicly accessible URL

Flow

Step 1: Prepare the Image

If the user provides a local file path, base64 encode it:

BASE64_IMAGE=$(base64 -i "<image_path>")
DATA_URI="data:image/png;base64,${BASE64_IMAGE}"

Step 2: Create Image-to-3D Task

curl -s https://api.meshy.ai/openapi/v1/image-to-3d \
  -X POST \
  -H "Authorization: Bearer ${MESHY_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_url": "<data_uri_or_public_url>",
    "ai_model": "meshy-6",
    "enable_pbr": true,
    "should_remesh": true,
    "should_texture": true,
    "topology": "quad",
    "target_polycount": 30000,
    "target_formats": ["glb"]
  }'

Response gives a task ID: {"result": "<task_id>"}

Step 3: Poll for Completion

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

Poll every 10 seconds. Check status field:

  • PENDING — queued
  • IN_PROGRESS — generating (check progress field for %)
  • SUCCEEDED — done, model_urls.glb has the download URL
  • FAILED — check task_error.message

Step 4: Download the GLB

curl -L -o "/Users/kevinbahrabadi/Blender Test/output/<filename>.glb" "<model_urls.glb>"

Step 5: Import into Blender

Use the Blender MCP execute_blender_code tool:

import bpy

# Clear scene (optional, based on user preference)
bpy.ops.object.select_all(action='SELECT')
bpy.ops.object.delete()

# Import GLB
bpy.ops.import_scene.gltf(filepath="/Users/kevinbahrabadi/Blender Test/output/<filename>.glb")

# Center and frame the imported object
bpy.ops.object.select_all(action='SELECT')
bpy.ops.view3d.view_selected()

Configuration Options

Option Default Description
ai_model meshy-6 Model to use. Options: meshy-5, meshy-6, latest
model_type standard standard for detail, lowpoly for clean game meshes
topology triangle quad or triangle mesh
target_polycount 30000 100–300,000 polygons
enable_pbr true Generate metallic/roughness/normal maps
symmetry_mode auto off, auto, or on
pose_mode "" a-pose, t-pose, or empty
should_texture true Generate textures (costs extra credits)
remove_lighting true Clean textures without baked lighting

Output

After completion, the user gets:

  • 3D model imported into Blender scene
  • Textured with PBR materials (if enabled)
  • Ready for rendering, animation, or further editing

Error Handling

  • 402: Insufficient Meshy credits — inform user
  • 429: Rate limited — wait and retry
  • FAILED status: Report task_error.message to user
  • Blender MCP disconnected: Ask user to reconnect addon

04 同仓库更多 Skills

siddu1004
siddu1004/SFP

scientific-schematics

Generates scientific diagram drafts using Nano Banana 2 AI with smart iterative refinement. Uses Gemini 3.7 Flash for quality review. Refines when the review requests improvement, with at most two generations. Specialized in neural network architectures, system diagrams, flowcharts, biological pathways, and complex scientific visualizations.

★ 5
siddu1004
siddu1004/SFP

polyhaven-texture-apply

Apply realistic PBR textures from PolyHaven to any Blender object. Supports metals, wood, concrete, fabric, and more. Trigger when asked to texture an object, apply a material from PolyHaven, make something look like metal/wood/marble, or change object surface.

★ 5
siddu1004
siddu1004/SFP

polyhaven-studio-setup

Set up a professional product photography studio in Blender using PolyHaven HDRIs and PBR ground materials. Trigger when asked to create a studio setup, add HDRI lighting, set up product photography, or create a showroom scene.

★ 5
siddu1004
siddu1004/SFP

polyhaven-scene-builder

Build complete product scenes using PolyHaven assets — HDRI environment, textured ground/pedestal, and optional props from the 3D model library. Trigger when asked to build a product scene, create a showcase setup, add a pedestal, or compose a product shot.

★ 5
siddu1004
siddu1004/SFP

polyhaven-material-swap

Cycle through multiple PolyHaven materials on a product and render each variant. Great for showing color/finish options. Trigger when asked to show material variants, swap textures, create color options, show finish comparisons, or render product in different materials.

★ 5
siddu1004
siddu1004/SFP

polyhaven-hdri-showcase

Render the same product across multiple HDRI environments and output a comparison grid. Trigger when asked to compare lighting setups, test different environments, show product in multiple settings, or create an HDRI comparison.

★ 5