imagesarrayrequired
1 to 4 images of the same object from different angles. Supports .jpg, .jpeg and .png; AVIF and HEIF are converted automatically.
Meshy 6 Multi-Image to 3D
meshy/meshy-v6/multi-image-to-3dMeshy 6 reconstructs a 3D model from 1–4 views of the same object, with optional textures, PBR maps, auto-rigging and animation.
Try the model
Playground
Input
PNG, JPEG, WebP, or GIF · 20 MiB maximum each · up to 4
1 to 4 images of the same object from different angles. Supports .jpg, .jpeg and .png; AVIF and HEIF are converted automatically.
Add at least one media item.
Advanced settings
Generate textures. Untextured meshes cost less.
Symmetry enforcement: off, auto or on. Allowed values: off, auto, on.
quad for smooth surfaces, triangle for detail. Allowed values: quad, triangle.
100300000
Target polygon count (100–300,000). Range: 100 to 300000.
Generate the character in an A-pose or T-pose; empty for no specific pose. Allowed values: a-pose, t-pose, .
Generate PBR maps (metallic, roughness, normal) in addition to base color.
Text prompt to guide texturing. Maximum 800 characters.
PNG, JPEG, WebP, or GIF · 20 MiB maximum
Image URL to guide texturing.
Rig the model as a humanoid character. The rigged GLB is returned as rigged_glb.
Apply an animation preset to the rigged character (billed together with rigging). The animated GLB is returned as animation_glb.
0696
Animation preset ID from Meshy's animation library (0 is Idle). Only used when animation is enabled. Range: 0 to 696.
ResultIdle
Your output will appear here
Complete the inputs, then click Run.
Meshy 6 Multi-Image to 3D
Meshy 6 reconstructs a 3D model from 1–4 views of the same object, with optional textures, PBR maps, auto-rigging and animation.
Fields
| Field | Type | Default | Notes |
|---|---|---|---|
images | image URLs (1–4), required | — | 1 to 4 images of the same object from different angles. Supports .jpg, .jpeg and .png; AVIF and HEIF are converted automatically. |
should_texture | boolean | true | Generate textures. Untextured meshes cost less. |
symmetry_mode | off / auto / on | auto | Symmetry enforcement: off, auto or on. |
topology | quad / triangle | triangle | quad for smooth surfaces, triangle for detail. |
target_polycount | integer 100–300000 | 30000 | Target polygon count (100–300,000). |
pose_mode | a-pose / t-pose / `` | "" | Generate the character in an A-pose or T-pose; empty for no specific pose. |
enable_pbr | boolean | false | Generate PBR maps (metallic, roughness, normal) in addition to base color. |
texture_prompt | string | — | Text prompt to guide texturing. Maximum 800 characters. |
texture_image | image URL | — | Image URL to guide texturing. |
enable_rigging | boolean | false | Rig the model as a humanoid character. The rigged GLB is returned as rigged_glb. |
enable_animation | boolean | false | Apply an animation preset to the rigged character (billed together with rigging). The animated GLB is returned as animation_glb. |
animation_action_id | integer 0–696 | 92 | Animation preset ID from Meshy's animation library (0 is Idle). Only used when animation is enabled. |
Output
url: Main 3D file (GLB unless another export format is selected).thumbnail: Preview image rendered by the provider.rigged_glb: Additional file returned by the provider.animation_glb: Additional file returned by the provider.
Billing
$1.20 per request with default settings. Price by option (other settings at default):
| Option | Price |
|---|---|
| enable_animation on | $1.52 |
| enable_animation off | $1.20 |
| enable_rigging on | $1.40 |
| enable_rigging off | $1.20 |
| should_texture on | $1.20 |
| should_texture off | $0.80 |
| Failed runs are not charged. |
Also on SandBase
Other Meshy 3D endpoints: meshy/6.0-lite/retexture, meshy/6.0/retexture, meshy/7.0/image-to-3d, meshy/7.0/multi-image-to-3d.
Start building
Send your first request
Submit this model through the SandBase Unified Run API.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/run" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"model": "meshy/meshy-v6/multi-image-to-3d",
"images": [
"https://v3b.fal.media/files/b/kangaroo/cPyD3-por0XI7jDa9F9vP_image%20(3).png",
"https://v3b.fal.media/files/b/elephant/9sd5JWAOJBcR7G3NMjPVs_image%20(2).png",
"https://v3b.fal.media/files/b/tiger/TP4sTzPATX_w1Tn4m6kYM_image%20(1).png"
],
"topology": "triangle",
"enable_pbr": false,
"symmetry_mode": "auto",
"enable_rigging": false,
"should_texture": true,
"enable_animation": false,
"target_polycount": 30000,
"animation_action_id": 92
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
status=$(printf '%s' "$result" | jq -r .status)
case "$status" in completed|failed|timeout) break ;; esac
sleep 2
result=$(curl --fail-with-body --silent \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
"https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"2. Authentication
Create a SandBase API key and set it in your server environment. All requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep the key on your server. Do not expose it in browser code or commit it to a repository.
3. Queue
Submit a request
POST to /v1/run with this model ID and its inputs. The request example above includes submission and polling.
Fetch request status and result
Use the returned run ID to poll until the status is completed, failed or timeout. Read output only after completed.
curl "https://api.sandbase.ai/v1/run/$RUN_ID" \
-H "Authorization: Bearer $SANDBASE_API_KEY"4. Files
Hosted files
Pass a publicly accessible file URL in the model’s image, video or audio field. Supported formats and limits are shown beside each Playground input.
Uploading images
Use the upload or replace control on supported image fields in the Playground. Video URL fields accept a hosted driving video; they do not imply video-upload support.
5. Schema
Input
topologystring
quad for smooth surfaces, triangle for detail.
Default: "triangle"
Possible values: "quad", "triangle"
pose_modestring
Generate the character in an A-pose or T-pose; empty for no specific pose.
Default: ""
Possible values: "a-pose", "t-pose", ""
enable_pbrboolean
Generate PBR maps (metallic, roughness, normal) in addition to base color.
Default: false
symmetry_modestring
Symmetry enforcement: off, auto or on.
Default: "auto"
Possible values: "off", "auto", "on"
texture_imagestring
Image URL to guide texturing.
enable_riggingboolean
Rig the model as a humanoid character. The rigged GLB is returned as rigged_glb.
Default: false
should_textureboolean
Generate textures. Untextured meshes cost less.
Default: true
texture_promptstring
Text prompt to guide texturing. Maximum 800 characters.
enable_animationboolean
Apply an animation preset to the rigged character (billed together with rigging). The animated GLB is returned as animation_glb.
Default: false
target_polycountinteger
Target polygon count (100–300,000).
Default: 30000
Minimum: 100
Maximum: 300000
animation_action_idinteger
Animation preset ID from Meshy's animation library (0 is Idle). Only used when animation is enabled.
Default: 92
Minimum: 0
Maximum: 696
{
"model": "meshy/meshy-v6/multi-image-to-3d",
"images": [
"https://v3b.fal.media/files/b/kangaroo/cPyD3-por0XI7jDa9F9vP_image%20(3).png",
"https://v3b.fal.media/files/b/elephant/9sd5JWAOJBcR7G3NMjPVs_image%20(2).png",
"https://v3b.fal.media/files/b/tiger/TP4sTzPATX_w1Tn4m6kYM_image%20(1).png"
],
"topology": "triangle",
"enable_pbr": false,
"symmetry_mode": "auto",
"enable_rigging": false,
"should_texture": true,
"enable_animation": false,
"target_polycount": 30000,
"animation_action_id": 92
}Output
A completed run exposes its result in output. The following is the model’s saved example, not a new generation.
No example output has been published yet. Use Playground → Result → JSON after a completed run to inspect your response.