Meshy 6 Preview

POST/v1/run

Meshy V6 Preview is Meshy's text-to-3D AI model. Turn written descriptions into textured 3D objects with realistic geometry and materials.

Request body

Submit an async generation request. The model field selects the model; other fields are model-specific input parameters.

stringmodelrequired

Model identifier. Set to meshy/meshy-v6-preview/text-to-3d.

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

stringpromptrequired

Describe what kind of object the 3D model is. Maximum 600 characters.

Optional<integer>seed

Seed for reproducible results. Same prompt and seed usually generate the same result.

Optional<string>symmetry_mode

Controls symmetry behavior during model generation.

Allowed values: off, auto, on

Default: auto

Optional<string>texture_image_url

2D image to guide the texturing process (only used in 'full' mode)

Optional<boolean>enable_animation

Apply an animation preset to the rigged model. Requires enable_rigging to be true.

Default: false

Optional<number>rigging_height_meters

Approximate height of the character in meters. Only used when enable_rigging is true.

Default: 1.7

Optional<integer>animation_action_id

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

Optional<integer>target_polycount

Target number of polygons in the generated model

Range: 100 to 300000

Default: 30000

Optional<boolean>enable_rigging

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

Optional<string>mode

Generation mode. 'preview' returns untextured geometry only, 'full' returns textured model (preview + refine).

Allowed values: preview, full

Default: full

Optional<string>texture_prompt

Additional text prompt to guide the texturing process (only used in 'full' mode)

Optional<string>topology

Specify the topology of the generated model. Quad for smooth surfaces, Triangle for detailed geometry.

Allowed values: quad, triangle

Default: triangle

Optional<boolean>enable_pbr

Generate PBR Maps (metallic, roughness, normal) in addition to base color.

Default: false

Optional<string>pose_mode

Pose mode for the generated model. 'a-pose' generates an A-pose, 't-pose' generates a T-pose, empty string for no specific pose.

Allowed values: a-pose, t-pose,

Default:

Optional<boolean>is_a_t_pose

Deprecated: use pose_mode instead. When true, generates a T-pose model.

Default: false

Optional<boolean>should_remesh

Whether to enable the remesh phase. When false, returns unprocessed triangular mesh.

Default: true

Response Schema

The submit endpoint returns an accepted generation task. Poll the result endpoint with the returned id for terminal outputs or errors.

Optional<string>error

Error message if the task failed. Empty on success.

stringidrequired

Unique identifier for the generation task.

Optional<string>model

Model ID used for the prediction.

Optional<array>outputs

Array of generated content. Empty when status is not completed.

stringstatusrequired

Status of the task: pending, running, completed, failed, or timeout.

Allowed values: pending, running, completed, failed, timeout

Model capabilities

array<string>capability_tagsrequired

Capabilities declared by the model registry.

Default: text-to-3d

stringexecution_moderequired

Execution mode declared by the model registry.

Default: async

# 1. Submit a generation request
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "meshy/meshy-v6-preview/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."
}'

# 2. If the response is still running, poll the returned id
curl https://api.sandbase.ai/v1/run/run_abc123 \
  -H "Authorization: Bearer $SANDBASE_API_KEY"

Response202 Accepted

{
  "id": "run_abc123",
  "model": "meshy/meshy-v6-preview/text-to-3d",
  "status": "running",
  "outputs": []
}