---
title: "meshy-v7-multi-image-to-3d (best)"
method: POST
path: "/api/v1/meshy-v7-multi-image-to-3d"
tags: ["3D Generation"]
---

# meshy-v7-multi-image-to-3d (best)

`POST /api/v1/meshy-v7-multi-image-to-3d`

## Request

- Base URL: `https://api.muapi.ai`
- URL: `https://api.muapi.ai/api/v1/meshy-v7-multi-image-to-3d`
- Auth: one of:
  - API key in header `x-api-key`
  - OAuth 2 (client credentials, token URL `https://api.muapi.ai/oauth/token`)

Reconstruct a 3D mesh from 1 to 4 reference images using Meshy V7 Multi-view. Supports topology options, polycount targets, symmetry, PBR materials, auto-rigging, and humanoid animation presets. Input: images_list. Output: .glb mesh with textures + preview. Use for: multi-angle photo-to-3D reconstruction, scanning-grade 3D assets.

## Query parameters

- `webhook` string
- `team_id` integer, nullable

## Headers

- `x-api-key` string
- `x-embed-code` string, nullable
- `x-agent-embed-code` string, nullable
- `x-whitelabel-studio` string, nullable
- `authorization` string, nullable

## Request body

- MeshyV7MultiImageTo3DRequest
  - `images_list` string[], required
  - `topology` 'quad' | 'triangle', nullable
  - `target_polycount` integer, nullable
  - `symmetry_mode` 'off' | 'auto' | 'on', nullable
  - `should_remesh` boolean, nullable
  - `should_texture` boolean, nullable
  - `enable_pbr` boolean, nullable
  - `pose_mode` string, nullable
  - `texture_prompt` string, nullable
  - `texture_image` string, uri, nullable
  - `enable_rigging` boolean, nullable
  - `rigging_height_meters` number, nullable
  - `enable_animation` boolean, nullable
  - `animation_action_id` integer, nullable
  - `webhook_url` string, uri, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/muapi/apis/muapi-api.md) · [All operations](https://skmtc.dev/muapi/apis/muapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/muapi/apis/muapi-api/revisions/e4b7374381e5?raw)