seedinteger
Seed for reproducible geometry.
Meshy T2 Text to 3D
meshy/t2/text-to-3dMeshy T2 generates a clean Smart Topology triangle mesh (up to 15,000 triangles) from a text prompt, untextured in preview mode or textured in full mode.
Try the model
Playground
Input
Describe the object to generate. Maximum 600 characters.
Advanced settings
'preview' returns the untextured mesh only; 'full' also textures it. Allowed values: preview, full.
Seed for reproducible geometry.
10015000
Target polygon count (100–15,000). Range: 100 to 15000.
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 Text to 3D
Meshy T2 generates a clean Smart Topology triangle mesh (up to 15,000 triangles) from a text prompt, untextured in preview mode or textured in full mode.
Fields
| Field | Type | Default | Notes |
|---|---|---|---|
prompt | string, required | — | Describe the object to generate. Maximum 600 characters. |
generation_mode | preview / full | full | 'preview' returns the untextured mesh only; 'full' also textures it. |
seed | integer | — | Seed for reproducible geometry. |
target_polycount | integer 100–15000 | 4000 | Target polygon count (100–15,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 |
| generation_mode = preview | $0.20 |
| generation_mode = full | $0.60 |
| 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/text-to-3d",
"prompt": "A rustic, antique wooden treasure chest with a curved, domed lid, reinforced with dark iron bands and a large circular lock plate on the front.",
"enable_pbr": false,
"enable_rigging": false,
"generation_mode": "full",
"enable_animation": false,
"target_polycount": 4000,
"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
promptstringrequired
Describe the object to generate. Maximum 600 characters.
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
texture_promptstring
Text 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_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–15,000).
Default: 4000
Minimum: 100
Maximum: 15000
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/text-to-3d",
"prompt": "A rustic, antique wooden treasure chest with a curved, domed lid, reinforced with dark iron bands and a large circular lock plate on the front.",
"enable_pbr": false,
"enable_rigging": false,
"generation_mode": "full",
"enable_animation": false,
"target_polycount": 4000,
"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.