API reference · Meshy

meshy/meshy-v6-preview/text-to-3d

Integrate this model through SandBase's unified API, with production-ready schemas and examples.

IMAGEAsyncOpen model

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDmeshy/meshy-v6-preview/text-to-3d

Input Schema

16 parameters · 1 required · 15 optional

Parameter	Type	Required	Description
`prompt`	string	Required	Describe what kind of object the 3D model is. Maximum 600 characters. · Max length: 600
`mode`	string	Optional	Generation mode. 'preview' returns untextured geometry only, 'full' returns textured model (preview + refine). · Options: preview, full · Default: "full" previewfull
`seed`	integer	Optional	Seed for reproducible results. Same prompt and seed usually generate the same result.
`topology`	string	Optional	Specify the topology of the generated model. Quad for smooth surfaces, Triangle for detailed geometry. · Options: quad, triangle · Default: "triangle" quadtriangle
`pose_mode`	string	Optional	Pose mode for the generated model. 'a-pose' generates an A-pose, 't-pose' generates a T-pose, empty string for no specific pose. · Options: a-pose, t-pose, · Default: "" a-poset-pose
`enable_pbr`	boolean	Optional	Generate PBR Maps (metallic, roughness, normal) in addition to base color. · Default: false
`is_a_t_pose`	boolean	Optional	Deprecated: use pose_mode instead. When true, generates a T-pose model. · Default: false
`should_remesh`	boolean	Optional	Whether to enable the remesh phase. When false, returns unprocessed triangular mesh. · Default: true
`symmetry_mode`	string	Optional	Controls symmetry behavior during model generation. · Options: off, auto, on · Default: "auto" offautoon
`enable_rigging`	boolean	Optional	Automatically rig the generated model as a humanoid character. Includes basic walking and running animations. Best results with humanoid characters that have clearly defined limbs. · Default: false
`texture_prompt`	string	Optional	Additional text prompt to guide the texturing process (only used in 'full' mode) · Max length: 600
`enable_animation`	boolean	Optional	Apply an animation preset to the rigged model. Requires enable_rigging to be true. · Default: false
`target_polycount`	integer	Optional	Target number of polygons in the generated model · Min: 100 · Max: 300000 · Default: 30000
`texture_image_url`	string	Optional	2D image to guide the texturing process (only used in 'full' mode)
`animation_action_id`	integer	Optional	Animation preset ID from Meshy's library (500+ presets). Only used when enable_animation is true. See https://docs.meshy.ai/en/api/animation-library for available action IDs. · Default: 1001
`rigging_height_meters`	number	Optional	Approximate height of the character in meters. Only used when enable_rigging is true. · Default: 1.7

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "meshy/meshy-v6-preview/text-to-3d",
  "mode": "full",
  "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",
  "pose_mode": "",
  "enable_pbr": false,
  "is_a_t_pose": false,
  "should_remesh": true,
  "symmetry_mode": "auto",
  "enable_rigging": false,
  "enable_animation": false,
  "target_polycount": 30000,
  "animation_action_id": 1001,
  "rigging_height_meters": 1.7
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Meshy 6 Preview