Meshy V7.1 Multi Image To 3d API Documentation

Meshy V7.1 Multi Image To 3d API Documentation

Playground

Meshy 7.1 Multi-Image-to-3D reconstructs textured, PBR-ready 3D models from one to four views of the same object, with 2K geometry resolution for finer detail and configurable topology, rigging, and animation for game assets, product visualization, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Meshy 7.1 Multi-Image to 3D reconstructs a textured 3D mesh from one to four images of the same object taken from different angles. Meshy 7.1 focuses on geometric detail: set geometry_resolution to 2k for finer surfaces and sharper silhouettes. It returns a GLB model, plus separate rigged and animated GLB files when rigging is enabled.

Why Choose This?

• Finer geometric detail geometry_resolution goes up to 2k, capturing small surface details and cleaner silhouettes — useful for close-up renders and 3D printing.

• Texture control Generate textured models, enable PBR maps, or guide textures with a prompt or reference image.

• Production geometry controls Adjust topology, target polygon count, symmetry, and remeshing.

• Optional rigging and animation Rig humanoid characters and apply animation presets in the same request.

• Rigged and animated GLB files With rigging enabled, the rigged character and its walking, running and preset animations come back as separate GLB files.

Parameters

Output

outputs is a list of GLB file URLs in this order:

Pricing

Example Costs

Other parameters do not add separate charges.

Pro Tips

• Use 2k geometry for hero assets, close-up renders, and 3D printing; use standard for quick iteration.
• Higher geometry resolution applies to standard geometry.
• Use texture_prompt to describe materials such as metal, leather, ceramic, fabric, or plastic.
• Enable rigging only for humanoid characters; animation requires rigging.
• Use consistent views of the same object with matching lighting and scale.

Related Models

• Meshy 7.1 Image to 3D — Generate from a single reference image, with up to 4K geometry.
• Meshy 7.1 Text to 3D — Generate a 3D model from a text prompt.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "images": [
    "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg"
  ],
  "topology": "triangle",
  "target_polycount": 30000,
  "symmetry_mode": "auto",
  "should_remesh": true,
  "should_texture": true,
  "enable_pbr": false,
  "geometry_resolution": "standard",
  "pose_mode": "a-pose",
  "enable_rigging": false,
  "rigging_height_meters": 1.7,
  "enable_animation": false,
  "animation_action_id": 92
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/meshy/v7.1/multi-image-to-3d" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}")
  RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout|deleted) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters