meshy/meshy-v6/multi-image-to-3d
Meshy V6 Multi Image To 3d by Meshy - convert 2D images into 3D models with AI. Generate textured 3D assets from single photos for games, AR/VR, e-commerce, and digital content creation.
PNG, JPEG, WebP, or GIF · 20 MiB maximum each
PNG, JPEG, WebP, or GIF · 20 MiB maximum
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runmeshy/meshy-v6/multi-image-to-3dInput Schema
15 parameters · 0 required · 15 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
images | string[] | Optional | 1 to 4 images for 3D model creation. All images should depict the same object from different angles. Supports .jpg, .jpeg, .png formats, and AVIF/HEIF which will be automatically converted. If more than 4 images are provided, only the first 4 will be used. |
topology | string | Optional | Specify the topology of the generated model. Quad for smooth surfaces, Triangle for detailed geometry. · Options: quad, triangle · Default: "triangle" quadtriangle |
pose_mode | string | Optional | Pose mode for the generated model. 'a-pose' generates an A-pose, 't-pose' generates a T-pose, empty string for no specific pose. · Options: a-pose, t-pose, · Default: "" a-poset-pose |
enable_pbr | boolean | Optional | Generate PBR Maps (metallic, roughness, normal) in addition to base color. Requires should_texture to be true. · Default: false |
is_a_t_pose | boolean | Optional | Deprecated: use pose_mode instead. When true, generates a T-pose model. · Default: false |
should_remesh | boolean | Optional | Whether to enable the remesh phase. When false, returns triangular mesh ignoring topology and target_polycount. · Default: true |
symmetry_mode | string | Optional | Controls symmetry behavior during model generation. · Options: off, auto, on · Default: "auto" offautoon |
enable_rigging | boolean | Optional | Automatically rig the generated model as a humanoid character. Includes basic walking and running animations. Best results with humanoid characters that have clearly defined limbs. · Default: false |
should_texture | boolean | Optional | Whether to generate textures. False provides mesh without textures for 5 credits, True adds texture generation for additional 10 credits. · Default: true |
texture_prompt | string | Optional | Text prompt to guide the texturing process. Requires should_texture to be true. · Max length: 600 |
enable_animation | boolean | Optional | Apply an animation preset to the rigged model. Requires enable_rigging to be true. · Default: false |
target_polycount | integer | Optional | Target number of polygons in the generated model · Min: 100 · Max: 300000 · Default: 30000 |
texture_image_url | string | Optional | 2D image to guide the texturing process. Requires should_texture to be true. |
animation_action_id | integer | Optional | Animation preset ID from Meshy's library (500+ presets). Only used when enable_animation is true. See https://docs.meshy.ai/en/api/animation-library for available action IDs. · Default: 1001 |
rigging_height_meters | number | Optional | Approximate height of the character in meters. Only used when enable_rigging is true. · Default: 1.7 |
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
Async Workflow
This model uses asynchronous execution. Submit a request and poll for the result.
- Submit — POST to /v1/run, receive an
id - Poll — GET /v1/run/{id} until status is
completed,failed, ortimeout - Retrieve — Read
outputsfrom the completed response
Code Examples
Ready-to-run snippets
# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "meshy/meshy-v6/multi-image-to-3d",
"images": [
"https://static.sandbase.ai/examples/meshy/meshy-v6/multi-image-to-3d/input_images_0.png",
"https://static.sandbase.ai/examples/meshy/meshy-v6/multi-image-to-3d/input_images_1.png",
"https://static.sandbase.ai/examples/meshy/meshy-v6/multi-image-to-3d/input_images_2.png"
],
"topology": "triangle",
"pose_mode": "",
"enable_pbr": false,
"is_a_t_pose": false,
"should_remesh": true,
"symmetry_mode": "auto",
"enable_rigging": false,
"should_texture": true,
"enable_animation": false,
"target_polycount": 30000,
"animation_action_id": 1001,
"rigging_height_meters": 1.7,
"prompt": "a beautiful sunset over mountains"
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
Meshy 6 - Multi Image To 3D
Meshy 6 - Multi Image To 3D is a Meshy route built for multi-view image-to-3D reconstruction. It turns several complementary object views into a textured 3D asset whose geometry is constrained by multiple angles, giving creators a focused endpoint instead of forcing one generic workflow across materially different production tasks. The route belongs to a family known for production-oriented 3D creation, editable assets, and fast iteration, so it is best evaluated as a creative system for intentional shots and assets rather than as a one-click novelty generator.
Use this endpoint when the input contract and deliverable match that job exactly. Its documented controls include topology choices (quad, triangle); pose_mode choices (a-pose, t-pose, ); enable_pbr (Generate PBR Maps (metallic, roughness, normal) in addition to base color. Requires should_texture to be true); is_a_t_pose (Deprecated: use pose_mode instead. When true, generates a T-pose model). Together, these controls help teams plan predictable iterations, compare outputs under stable settings, and connect generation to game, product, visualization, and spatial-content pipelines without hiding the operational choices that shape the result.
Highlights
- Meshy 6 - Multi Image To 3D: dedicated multi-view reconstruction. This exact route centers on multi-view reconstruction; it uses the schema-defined source fields to separate its job from neighboring endpoints in the same family.
imagescontrol. 1 to 4 images for 3D model creation. All images should depict the same object from different angles. Supports .jpg, .jpeg, .png formats, and AVIF/HEIF which will be automatically converted. If more than 4 images are provided, only the first 4 will be used; this setting provides a concrete lever for route-specific output planning.topologycontrol. optionsquad,triangle; use it to build controlled comparisons without changing the rest of the request.pose_modecontrol. optionsa-pose,t-pose, ``; together with the other documented fields, it supports repeatable review of this model path.
Pricing
| Configuration | Price |
|---|---|
| Standard request | $0.800000 |
When to Use
| Scenario | Why this model fits |
|---|---|
| Create the exact route output | Choose it when you need multi-view image-to-3D reconstruction and already have several complementary object views. |
| Develop controlled variations | Keep the main brief fixed while changing one documented setting at a time to compare motion, framing, quality, or asset behavior. |
| Build repeatable batches | Use a consistent request shape for catalog, campaign, storyboard, game-asset, or social-content production. |
| Preserve source intent | Prefer this route when the supplied reference material must remain the foundation of a textured 3D asset whose geometry is constrained by multiple angles. |
| Connect a media pipeline | Use asynchronous results in an automated review, approval, post-production, or asset-management workflow. |
Prompt Guide
Start with the desired result, then describe the source relationship, subject action, composition or camera behavior, lighting, style, and timing. For multi-view image-to-3D reconstruction, state what must remain stable as clearly as what should change. Use only fields exposed by the schema; the example below is structurally valid for this route.
{
"images": [
"https://static.sandbase.ai/examples/meshy/meshy-v6/multi-image-to-3d/input_images_0.png",
"https://static.sandbase.ai/examples/meshy/meshy-v6/multi-image-to-3d/input_images_1.png",
"https://static.sandbase.ai/examples/meshy/meshy-v6/multi-image-to-3d/input_images_2.png"
],
"topology": "triangle",
"pose_mode": "",
"enable_pbr": false,
"is_a_t_pose": false
}
Technical Specs
| Specification | Value |
|---|---|
| Model ID | meshy/meshy-v6/multi-image-to-3d |
| Workflow | Multi-view image-to-3d reconstruction |
| Required inputs | No fields marked required by schema |
images | array |
topology | string; options: quad, triangle |
pose_mode | string; options: a-pose, t-pose, `` |
enable_pbr | boolean |
is_a_t_pose | boolean |
should_remesh | boolean |
symmetry_mode | string; options: off, auto, on |
enable_rigging | boolean |
should_texture | boolean |
texture_prompt | string |

