Meshy modelsimage generation api

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

Name: Meshy 6 Preview
Author: Meshy

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

Input

Prompt(string)

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

Seed(integer)

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

Symmetry Mode(string)

Controls symmetry behavior during model generation. Allowed values: off, auto, on.

Image URL or upload(string)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum

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

Enable Animation(boolean)

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

Rigging Height Meters(number)

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

Animation Action Id(integer)

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.

Target Polycount(integer)

100300000

Target number of polygons in the generated model Range: 100 to 300000.

Enable Rigging(boolean)

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.

Mode(string)

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

Texture Prompt(string)

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

Topology(string)

Specify the topology of the generated model. Quad for smooth surfaces, Triangle for detailed geometry. Allowed values: quad, triangle.

Enable Pbr(boolean)

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

Pose Mode(string)

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, .

Is A T Pose(boolean)

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

Should Remesh(boolean)

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

Idle

Example output — click Run to generate your own

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

API README

Meshy 6 Preview

Meshy 6 Preview is a Meshy route built for text-to-3D creation. It turns a concrete written object brief into a textured 3D asset ready for downstream inspection, giving creators a focused endpoint instead of forcing one generic workflow across materially different production tasks. The route belongs to a family known for production-oriented 3D creation, editable assets, and fast iteration, so it is best evaluated as a creative system for intentional shots and assets rather than as a one-click novelty generator.

Use this endpoint when the input contract and deliverable match that job exactly. Its documented controls include mode choices (preview, full); seed (Seed for reproducible results. Same prompt and seed usually generate the same result); topology choices (quad, triangle); pose_mode choices (a-pose, t-pose, ). Together, these controls help teams plan predictable iterations, compare outputs under stable settings, and connect generation to game, product, visualization, and spatial-content pipelines without hiding the operational choices that shape the result.

Highlights

Meshy 6 Preview: dedicated text-driven 3D creation. This exact route centers on text-driven 3D creation; it uses prompt to separate its job from neighboring endpoints in the same family.
mode control. options preview, full; this setting provides a concrete lever for route-specific output planning.
seed control. Seed for reproducible results. Same prompt and seed usually generate the same result; use it to build controlled comparisons without changing the rest of the request.
topology control. options quad, triangle; together with the other documented fields, it supports repeatable review of this model path.

Pricing

Configuration	Price
Standard request	`$0.800000`

When to Use

Scenario	Why this model fits
Create the exact route output	Choose it when you need text-to-3D creation and already have a concrete written object brief.
Develop controlled variations	Keep the main brief fixed while changing one documented setting at a time to compare motion, framing, quality, or asset behavior.
Build repeatable batches	Use a consistent request shape for catalog, campaign, storyboard, game-asset, or social-content production.
Preserve source intent	Prefer this route when the supplied reference material must remain the foundation of a textured 3D asset ready for downstream inspection.
Connect a media pipeline	Use asynchronous results in an automated review, approval, post-production, or asset-management workflow.

Prompt Guide

Start with the desired result, then describe the source relationship, subject action, composition or camera behavior, lighting, style, and timing. For text-to-3D creation, state what must remain stable as clearly as what should change. Use only fields exposed by the schema; the example below is structurally valid for this route.

{
  "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.",
  "mode": "full",
  "seed": 1,
  "topology": "triangle",
  "pose_mode": ""
}

Technical Specs

Specification	Value
Model ID	`meshy/meshy-v6-preview/text-to-3d`
Workflow	Text-to-3d creation
Required inputs	`prompt`
`mode`	`string`; options: `preview`, `full`
`seed`	`integer`
`prompt`	`string`
`topology`	`string`; options: `quad`, `triangle`
`pose_mode`	`string`; options: `a-pose`, `t-pose`, ``
`enable_pbr`	`boolean`
`is_a_t_pose`	`boolean`
`should_remesh`	`boolean`
`symmetry_mode`	`string`; options: `off`, `auto`, `on`
`enable_rigging`	`boolean`

Related Models

meshy/meshy-v6-preview