seedinteger
Seed for reproducible geometry.
Meshy 7 Text to 3D
meshy/7.0/text-to-3dMeshy 7 generates a 3D model from a text prompt, either as an untextured preview mesh or fully textured, with optional 2K geometry, rigging and animation.
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.
Symmetry enforcement: off, auto or on. Allowed values: off, auto, on.
quad for smooth surfaces, triangle for detail. Allowed values: quad, triangle.
Geometry resolution. 2k gives finer geometry at a higher price. Allowed values: standard, 2k.
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 7 Text to 3D
Meshy 7 generates a 3D model from a text prompt, either as an untextured preview mesh or fully textured, with optional 2K geometry, rigging and animation.
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. |
symmetry_mode | off / auto / on | auto | Symmetry enforcement: off, auto or on. |
topology | quad / triangle | triangle | quad for smooth surfaces, triangle for detail. |
geometry_resolution | standard / 2k | standard | Geometry resolution. 2k gives finer geometry at a higher price. |
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 |
| generation_mode = preview | $0.80 |
| generation_mode = full | $1.20 |
| geometry_resolution = standard | $1.20 |
| geometry_resolution = 2k | $1.40 |
| 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/7.0/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,
"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
promptstringrequired
Describe the object to generate. Maximum 600 characters.
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
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–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
geometry_resolutionstring
Geometry resolution. 2k gives finer geometry at a higher price.
Default: "standard"
Possible values: "standard", "2k"
{
"model": "meshy/7.0/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,
"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.