seedinteger
Seed for reproducible geometry.
meshy/6.0-lite/text-to-3dMeshy 6 Lite turns a text prompt into a 3D model at a lower price: a preview mesh, then textures, with optional humanoid rigging and animation.
Try the model
PNG, JPEG, WebP, or GIF · 20 MiB maximum

What would you like to do next?
Select an example to load its inputs and result into the playground.
{
"prompt": "A rustic, antique wooden treasure chest with a curved, domed lid, constructed from weathered, dark brown planks with iron bands, rivets and an ornate circular lock plate."
}{
"generation_mode": "preview",
"prompt": "a vintage brass telescope on a wooden tripod"
}Meshy 6 Lite turns a text prompt into a 3D model at a lower price: a preview mesh, then textures, with optional humanoid rigging and animation.
| Field | Type | Default | Notes |
|---|---|---|---|
seed | integer | — | Seed for reproducible geometry. |
prompt | string, required | — | Describe the object to generate. Maximum 600 characters. |
topology | quad / triangle | "triangle" | quad for smooth surfaces, triangle for detail. |
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. |
symmetry_mode | off / auto / on | "auto" | Symmetry enforcement: off, auto or on. |
texture_image | string | — | Image URL to guide texturing. |
enable_rigging | boolean | false | Rig the model as a humanoid character. The rigged GLB is returned as rigged_glb. |
texture_prompt | string | — | Text prompt to guide texturing. Maximum 800 characters. |
generation_mode | preview / full | "full" | 'preview' returns the untextured mesh only; 'full' also textures it. |
enable_animation | boolean | false | Apply an animation preset to the rigged character (billed together with rigging). The animated GLB is returned as animation_glb. |
target_polycount | integer 100–300000 | 30000 | Target polygon count (100–300,000). |
animation_action_id | integer 0–696 | 92 | Animation preset ID from Meshy's animation library (0 is Idle). Only used when animation is enabled. |
url: GLB model.thumbnail: Preview image.rigged_glb: Rigged character (when rigging is enabled).animation_glb: Animated character (when animation is enabled).$0.60 per textured model, $0.20 untextured (text-to-3d: generation_mode=preview). Rigging adds $0.20; animation adds $0.12 on top of rigging.
Start building
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/6.0-lite/text-to-3d",
"prompt": "A rustic, antique wooden treasure chest with a curved, domed lid, constructed from weathered, dark brown planks exhibiting prominent wood grain and subtle distress. It's heavily reinforced with broad, dark grey, oxidized metal bands secured by numerous circular rivets. Ornate, dark iron decorative elements featuring swirling foliate patterns and dragon motifs adorn the corners and lid. A prominent, circular, intricately carved metal lock plate with a central keyhole dominates the front, flanked by two large, dark metallic pull rings.",
"topology": "triangle",
"enable_pbr": false,
"symmetry_mode": "auto",
"enable_rigging": false,
"generation_mode": "full",
"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"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.
POST to /v1/run with this model ID and its inputs. The request example above includes submission and polling.
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"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.
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.
seedintegerSeed for reproducible geometry.
promptstringrequiredDescribe the object to generate. Maximum 600 characters.
topologystringquad for smooth surfaces, triangle for detail.
Default: "triangle"
Possible values: "quad", "triangle"
pose_modestringGenerate the character in an A-pose or T-pose; empty for no specific pose.
Default: ""
Possible values: "a-pose", "t-pose", ""
enable_pbrbooleanGenerate PBR maps (metallic, roughness, normal) in addition to base color.
Default: false
symmetry_modestringSymmetry enforcement: off, auto or on.
Default: "auto"
Possible values: "off", "auto", "on"
texture_imagestringImage URL to guide texturing.
enable_riggingbooleanRig the model as a humanoid character. The rigged GLB is returned as rigged_glb.
Default: false
texture_promptstringText prompt to guide texturing. Maximum 800 characters.
generation_modestring'preview' returns the untextured mesh only; 'full' also textures it.
Default: "full"
Possible values: "preview", "full"
enable_animationbooleanApply an animation preset to the rigged character (billed together with rigging). The animated GLB is returned as animation_glb.
Default: false
target_polycountintegerTarget polygon count (100–300,000).
Default: 30000
Minimum: 100
Maximum: 300000
animation_action_idintegerAnimation preset ID from Meshy's animation library (0 is Idle). Only used when animation is enabled.
Default: 92
Minimum: 0
Maximum: 696
{
"model": "meshy/6.0-lite/text-to-3d",
"prompt": "A rustic, antique wooden treasure chest with a curved, domed lid, constructed from weathered, dark brown planks exhibiting prominent wood grain and subtle distress. It's heavily reinforced with broad, dark grey, oxidized metal bands secured by numerous circular rivets. Ornate, dark iron decorative elements featuring swirling foliate patterns and dragon motifs adorn the corners and lid. A prominent, circular, intricately carved metal lock plate with a central keyhole dominates the front, flanked by two large, dark metallic pull rings.",
"topology": "triangle",
"enable_pbr": false,
"symmetry_mode": "auto",
"enable_rigging": false,
"generation_mode": "full",
"enable_animation": false,
"target_polycount": 30000,
"animation_action_id": 92
}A completed run exposes its result in output. The following is the model’s saved example, not a new generation.
[
{
"poster": "https://static.sandbase.ai/examples/d577ecfe-1624-40fc-8305-6840912c990a/output/ae40d624-5a66-400f-89b1-eb5242637b56.png",
"thumbnail": "https://static.sandbase.ai/examples/d577ecfe-1624-40fc-8305-6840912c990a/output/ae40d624-5a66-400f-89b1-eb5242637b56.png",
"url": "https://static.sandbase.ai/examples/d577ecfe-1624-40fc-8305-6840912c990a/output/5afcf721-4702-4b0d-babb-941fb75b24dd.glb"
}
]