imagestringrequired
Image URL or base64 data URI of the object. Supports .jpg, .jpeg and .png; AVIF and HEIF are converted automatically.
Meshy T2.5 Image to 3D
meshy/t2.5/image-to-3dMeshy T2.5 turns a single image into a clean Smart Topology triangle mesh (up to 30,000 triangles), with optional textures, rigging and animation.
Try the model
Playground
Input
PNG, JPEG, WebP, or GIF · 20 MiB maximum
Image URL or base64 data URI of the object. Supports .jpg, .jpeg and .png; AVIF and HEIF are converted automatically.
This field is required.
Advanced settings
Generate textures. Untextured meshes cost less.
10030000
Target polygon count (100–30,000). Range: 100 to 30000.
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 T2.5 Image to 3D
Meshy T2.5 turns a single image into a clean Smart Topology triangle mesh (up to 30,000 triangles), with optional textures, rigging and animation.
Fields
| Field | Type | Default | Notes |
|---|---|---|---|
image | image URL, required | — | Image URL or base64 data URI of the object. Supports .jpg, .jpeg and .png; AVIF and HEIF are converted automatically. |
should_texture | boolean | true | Generate textures. Untextured meshes cost less. |
target_polycount | integer 100–30000 | 15000 | Target polygon count (100–30,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
$0.60 per request with default settings. Price by option (other settings at default):
| Option | Price |
|---|---|
| enable_animation on | $0.92 |
| enable_animation off | $0.60 |
| enable_rigging on | $0.80 |
| enable_rigging off | $0.60 |
| should_texture on | $0.60 |
| should_texture off | $0.20 |
| 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/t2.5/image-to-3d",
"image": "https://v3b.fal.media/files/b/zebra/3osHJDI8IZ2wl6sGtEUeB_image.png",
"enable_pbr": false,
"enable_rigging": false,
"should_texture": true,
"enable_animation": false,
"target_polycount": 15000,
"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
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
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–30,000).
Default: 15000
Minimum: 100
Maximum: 30000
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/t2.5/image-to-3d",
"image": "https://v3b.fal.media/files/b/zebra/3osHJDI8IZ2wl6sGtEUeB_image.png",
"enable_pbr": false,
"enable_rigging": false,
"should_texture": true,
"enable_animation": false,
"target_polycount": 15000,
"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.