Meshy-6
Meshy-6 is a 3D generation model for text-to-3D and image-to-3D workflows. It is built for cleaner geometry, sharper hard-surface detail, low-poly generation, configurable quad or triangle topology, polycount and symmetry control, A/T pose support, and textured outputs with optional PBR materials. It fits game asset creation, 3D printing, and production-oriented 3D pipelines.
API Options
Platform-level options for task execution and delivery.
-
taskType
string required value: 3dInference -
Identifier for the type of task being performed
-
taskUUID
string required UUID v4 -
UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.
-
outputType
string default: URL -
3D output type.
Allowed values 1 value
-
outputFormat
string default: GLB -
Specifies the file format of the generated output. The available values depend on the task type and the specific model's capabilities.
- `GLB`: Binary glTF format for 3D models, including geometry, textures, and PBR materials.
Allowed values 1 value
-
webhookURL
string URI -
Specifies a webhook URL where JSON responses will be sent via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.
Learn more 1 resource
- Webhooks PLATFORM
- Webhooks
-
deliveryMethod
string default: async -
Determines how the API delivers task results.
Allowed values 2 values
- Returns complete results directly in the API response.
- Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse.
Learn more 1 resource
- Task Polling PLATFORM
-
uploadEndpoint
string URI -
Specifies a URL where the generated content will be automatically uploaded using the HTTP PUT method. The raw binary data of the media file is sent directly as the request body. For secure uploads to cloud storage, use presigned URLs that include temporary authentication credentials.
Common use cases:
- Cloud storage: Upload directly to S3 buckets, Google Cloud Storage, or Azure Blob Storage using presigned URLs.
- CDN integration: Upload to content delivery networks for immediate distribution.
// S3 presigned URL for secure upload https://your-bucket.s3.amazonaws.com/generated/content.mp4?X-Amz-Signature=abc123&X-Amz-Expires=3600 // Google Cloud Storage presigned URL https://storage.googleapis.com/your-bucket/content.jpg?X-Goog-Signature=xyz789 // Custom storage endpoint https://storage.example.com/uploads/generated-image.jpgThe content data will be sent as the request body to the specified URL when generation is complete.
-
ttl
integer min: 60 -
Time-to-live (TTL) in seconds for generated content. Only applies when
outputTypeisURL.
-
includeCost
boolean default: false -
Include task cost in the response.
-
numberResults
integer min: 1 max: 4 default: 1 -
Number of results to generate. Each result uses a different seed, producing variations of the same parameters.
Inputs
Input resources for the task (images, audio, etc). These must be nested inside the inputs object.
inputs object.-
inputs»referenceImagesreferenceImages
array of strings items: 1 -
List of reference images (UUID, URL, Data URI, or Base64). Used to guide the texturing process.
-
inputs»imagesimages
array of strings min items: 1max items: 4 -
Array of image inputs (UUID, URL, Data URI, or Base64). For single image-to-3D, provide 1 image. For multi-image-to-3D, provide 2–4 images.
Generation Parameters
Core parameters for controlling the generated content.
-
model
string required value: meshy:meshy@6 -
Identifier of the model to use for generation.
Learn more 3 resources
-
positivePrompt
string max: 600 -
Text prompt describing elements to include in the generated output.
Learn more 2 resources
Settings
Technical parameters to fine-tune the inference process. These must be nested inside the settings object.
settings object.-
settings»autoSizeautoSize
boolean default: false -
AI-based real-world height estimation to resize the model accordingly.
-
settings»decimationdecimation
integer -
Adaptive decimation level.
Allowed values 4 values
- Ultra polycount.
- High polycount.
- Medium polycount.
- Low polycount.
-
settings»hdTexturehdTexture
boolean default: false -
Base colour texture at 4K (4096×4096) resolution. PBR maps are always generated at 2K regardless.
-
settings»imageEnhancementimageEnhancement
boolean default: true -
Input image optimization for better generation results. Set to false to preserve the exact appearance of the input.
-
settings»meshTypemeshType
string default: standard -
Mesh generation type for the output 3D model.
Allowed values 2 values
-
settings»moderationmoderation
boolean default: false -
Input content screening for potentially harmful material before generation proceeds.
-
settings»originorigin
string default: bottom -
Origin point position for the generated model.
Allowed values 2 values
-
settings»pbrpbr
boolean default: false -
PBR map generation (metallic, roughness, normal) in addition to base colour. Includes an emission map.
-
settings»polyCountpolyCount
integer min: 100 max: 300000 default: 30000 -
Target polygon count. Actual count may deviate based on geometry complexity.
-
settings»posepose
string default: none -
Pose preset for the generated model.
Allowed values 3 values
-
settings»remeshremesh
boolean default: false -
Remesh phase toggle. When false, returns the highest-precision triangular mesh without decimation.
-
settings»removeLightingremoveLighting
boolean default: true -
Highlight and shadow removal from the base colour texture, producing a cleaner result for custom lighting.
-
settings»symmetrysymmetry
string default: auto -
Symmetry behaviour during generation.
Allowed values 3 values
-
settings»texturetexture
boolean default: true -
Texture generation toggle. When false, returns a mesh only.
-
settings»texturePrompttexturePrompt
string max: 600 -
Additional text prompt to guide the texturing process.
-
settings»topologytopology
string default: triangle -
Mesh topology for the output model.
Allowed values 2 values