imagestringrequired
Image URL or base64 data URI for 3D model creation. Supports .jpg, .jpeg, and .png formats. Also supports AVIF and HEIF formats which will be automatically converted.
Meshy 7.1 Image to 3D
meshy/7.1/image-to-3dMeshy 7.1 turns a single image into a textured, optionally rigged and animated 3D model.
Try the model
Playground
Input
PNG, JPEG, WebP, or GIF · 20 MiB maximum
Image URL or base64 data URI for 3D model creation. Supports .jpg, .jpeg, and .png formats. Also supports AVIF and HEIF formats which will be automatically converted.
This field is required.
Additional Settings More
Customize your input with more control.
off / auto / on. Allowed values: off, auto, on.
Rig the model as a humanoid character (+$0.20).
standard, lowpoly or smart-topology. Allowed values: standard, lowpoly, smart-topology.
Generate PBR maps (metallic, roughness, normal).
a-pose, t-pose or empty for none. Allowed values: a-pose, t-pose, .
Generate textures (untextured models are cheaper).
Apply an animation preset; requires enable_rigging (+$0.12).
Text prompt to guide texturing.
Geometry resolution. Allowed values: standard, 2k, 4k.
100300000
Target polygon count (100–300,000). Range: 100 to 300000.
quad for smooth surfaces, triangle for detail. Allowed values: quad, triangle.
PNG, JPEG, WebP, or GIF · 20 MiB maximum
Image URL to guide texturing.
ResultIdle
Your output will appear here
Complete the inputs, then click Run.
Meshy 7.1 Image to 3D
Meshy 7.1 turns a single image into a textured 3D model, optionally rigged and animated.
Fields
| Field | Type | Default | Notes |
|---|---|---|---|
image | image URL, required | — | Image URL or base64 data URI for 3D model creation. |
symmetry_mode | off / auto / on | auto | Enforce symmetry. |
enable_rigging | boolean | false | Add a humanoid rig. |
model_type | standard / lowpoly / smart-topology | standard | Mesh style. |
enable_pbr | boolean | false | PBR texture maps. |
pose_mode | a-pose / t-pose / `` | — | Force an A- or T-pose. |
should_texture | boolean | true | Generate textures; untextured costs less. |
enable_animation | boolean | false | Add a walk/run animation (requires rigging). |
texture_prompt | string | — | Optional texture description. |
geometry_resolution | standard / 2k / 4k | standard | Mesh detail; higher tiers cost more. |
target_polycount | integer 100–300000 | 30000 | Target polygon count. |
topology | quad / triangle | triangle | Quad or triangle mesh. |
texture_image | image URL | — | Optional texture reference image. |
Billing
$1.44 per textured model ($0.96 untextured); 2K geometry adds $0.24 and 4K adds $0.48; rigging adds $0.24 and animation another $0.144.
| Request | Price |
|---|---|
| Textured | $1.44 |
| Untextured | $0.96 |
| Textured, 2K geometry | $1.68 |
| Textured + rig + animation | $1.824 |
Failed runs are not charged.
Prompting
- Describe or show one object; plain backgrounds work best.
Also on SandBase
Other Meshy 7.1 endpoints: meshy/7.1/text-to-3d, meshy/7.1/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/7.1/image-to-3d",
"image": "https://v3b.fal.media/files/b/zebra/3osHJDI8IZ2wl6sGtEUeB_image.png",
"topology": "triangle",
"enable_pbr": false,
"model_type": "standard",
"symmetry_mode": "auto",
"enable_rigging": false,
"should_texture": true,
"enable_animation": false,
"target_polycount": 30000,
"geometry_resolution": "standard"
}
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
a-pose, t-pose or empty for none.
Default: ""
Possible values: "a-pose", "t-pose", ""
enable_pbrboolean
Generate PBR maps (metallic, roughness, normal).
Default: false
model_typestring
standard, lowpoly or smart-topology.
Default: "standard"
Possible values: "standard", "lowpoly", "smart-topology"
symmetry_modestring
off / auto / on.
Default: "auto"
Possible values: "off", "auto", "on"
texture_imagestring
Image URL to guide texturing.
enable_riggingboolean
Rig the model as a humanoid character (+$0.20).
Default: false
should_textureboolean
Generate textures (untextured models are cheaper).
Default: true
texture_promptstring
Text prompt to guide texturing.
enable_animationboolean
Apply an animation preset; requires enable_rigging (+$0.12).
Default: false
target_polycountinteger
Target polygon count (100–300,000).
Default: 30000
Minimum: 100
Maximum: 300000
geometry_resolutionstring
Geometry resolution.
Default: "standard"
Possible values: "standard", "2k", "4k"
{
"model": "meshy/7.1/image-to-3d",
"image": "https://v3b.fal.media/files/b/zebra/3osHJDI8IZ2wl6sGtEUeB_image.png",
"topology": "triangle",
"enable_pbr": false,
"model_type": "standard",
"symmetry_mode": "auto",
"enable_rigging": false,
"should_texture": true,
"enable_animation": false,
"target_polycount": 30000,
"geometry_resolution": "standard"
}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.