Meshy

GENERATION API CALLS

3D Model Generation

This page is auto-generated from model configurations. Last updated: 2026-09-03.

This reference lists all available Meshy 3d generation models and their parameters. Use these parameter names when calling the Generation API.

Meshy 6 - Image-to-3D
Meshy 6 - Multi Image to 3D
Meshy 6 - Text-to-3D
Meshy 7 - Image to 3D
Meshy 7 - Multi Image to 3D
Meshy 7 - Retexture
Meshy 7 - Text-to-3D
Meshy Animation
Meshy Remesh
Meshy Retexture
Meshy Rigging
Meshy T2 Smart Topology
Meshy Text to Motion
Meshy UV Unwrap

Meshy 6 - Image-to-3D

Model ID: model_meshy-img23d

Capabilities: img23d

LLM Markdown: https://app.scenario.com/api/models/model_meshy-img23d/markdown

Parameter	Type	Required	Default	Min	Max	Allowed Values	Description
`image`	file_array	Yes	-	-	-	-	Upload one image to convert it into 3D, or provide up to four images from multiple angles for higher accuracy.
`texturePrompt`	string	No	-	-	-	-	Provide a text description to guide the texturing process. The Style Prompt is only used when no Style Image is provided. If you upload an image, this text prompt will be ignored.
`textureImage`	file	No	-	-	-	-	Upload a reference image to guide the visual style of the generated texture. This will override the Style Prompt. Requires the Texture setting to be enabled (toggle ON).
`shouldTexture`	boolean	No	`true`	-	-	-	Enable texture generation for a fully colored model. Disable to create a plain, untextured mesh.
`textureResolution`	string	No	`2k`	-	-	`2k`, `4k`, `8k`	Base color texture resolution: 2K (2048), 4K (4096), or 8K (8192). Requires Texture to be enabled. 4K/8K take effect on Meshy 6; other models ignore them. At 8K, PBR maps are generated at 4K and no emission map is produced. 8K is only supported with triangle topology when remeshing.
`topology`	string	No	`triangle`	-	-	`triangle`, `quad`	Choose the mesh structure type used for the generated model (e.g., triangles or quads).
`enablePbr`	boolean	No	`true`	-	-	-	Generate advanced PBR maps (metallic, roughness, normal) for more realistic materials. Requires the Texture setting to be enabled (toggle ON).
`poseMode`	string	No	-	-	-	“, `a-pose`, `t-pose`	Specify the pose mode for the generated model. Accepts ‘A-Pose’, ‘T-Pose’, or empty string (default).
`shouldRemesh`	boolean	No	`false`	-	-	-	Enable remeshing to improve mesh quality and control polycount. Disable to keep the raw, unprocessed mesh.
`targetPolycount`	number	No	`30000`	100	300000	-	Specify the target number of polygons in the generated model. The actual number of polygons may deviate from the target depending on the complexity of the geometry.

Meshy 6 - Multi Image to 3D

Meshy multi-view image-to-3D: combine 1–4 reference images (or a prior image task) into one 3D asset with optional PBR texturing.

Model ID: model_meshy-multi-image-to-3d

Capabilities: img23d

LLM Markdown: https://app.scenario.com/api/models/model_meshy-multi-image-to-3d/markdown

Parameter	Type	Required	Default	Min	Max	Allowed Values	Description
`image`	file_array	Yes	-	-	-	-	Provide 1–4 images from multiple angles for higher-quality 3D.
`shouldTexture`	boolean	No	`true`	-	-	-	Generate textures for a fully colored model. Disable for an untextured mesh (lower cost).
`enablePbr`	boolean	No	`false`	-	-	-	Generate PBR maps (metallic, roughness, normal, emission) in addition to base color. Requires texture generation.
`textureResolution`	string	No	`2k`	-	-	`2k`, `4k`, `8k`	Base color texture resolution: 2K (2048), 4K (4096), or 8K (8192). 4K/8K take effect on Meshy 6; other models ignore them. At 8K, PBR maps are generated at 4K and no emission map is produced. 8K is only supported with triangle topology when remeshing.
`texturePrompt`	string	No	-	-	-	-	Optional text to guide texturing (max 600 characters).
`textureImage`	file	No	-	-	-	-	Optional 2D image to guide texturing (.jpg, .jpeg, .png). Requires texture generation.
`topology`	string	No	`triangle`	-	-	`triangle`, `quad`	Mesh topology for the generated model.
`targetPolycount`	number	No	`30000`	100	300000	-	Target polygon count; actual count may vary with geometry complexity.
`savePreRemeshedModel`	boolean	No	`false`	-	-	-	Store the GLB before the remesh phase.
`poseMode`	string	No	-	-	-	“, `a-pose`, `t-pose`	Pose for the generated model: A-Pose, T-Pose, or none.
`imageEnhancement`	boolean	No	`true`	-	-	-	Optimize input images. Supported on Meshy 6 only.
`removeLighting`	boolean	No	`true`	-	-	-	Remove highlights and shadows from input images. Supported on Meshy 6 only.
`autoSize`	boolean	No	`false`	-	-	-	Estimate real-world scale for the generated model.
`originAt`	string	No	`bottom`	-	-	`bottom`, `center`	Place the model origin at the bottom or center.

Meshy 6 - Text-to-3D

Model ID: model_meshy-txt23d

Capabilities: txt23d

LLM Markdown: https://app.scenario.com/api/models/model_meshy-txt23d/markdown

Parameter	Type	Required	Default	Min	Max	Allowed Values	Description
`prompt`	string	Yes	-	-	-	-	Describe the object you want to generate as a 3D model.
`texturePrompt`	string	No	-	-	-	-	Provide a text description to guide the texturing process. The Style Prompt is only used when no Style Image is provided. If you upload an image, this text prompt will be ignored.
`textureImage`	file	No	-	-	-	-	Upload a reference image to guide the visual style of the generated texture. This will override the Style Prompt.
`topology`	string	No	`triangle`	-	-	`triangle`, `quad`	Choose the mesh structure type used for the generated model (e.g., triangles or quads).
`textureResolution`	string	No	`2k`	-	-	`2k`, `4k`, `8k`	Base color texture resolution for the refine phase: 2K (2048), 4K (4096), or 8K (8192). 4K/8K take effect on Meshy 6; other models ignore them. At 8K, PBR maps are generated at 4K and no emission map is produced. 8K is only supported with triangle topology when remeshing.
`enablePbr`	boolean	No	`true`	-	-	-	Generate advanced PBR maps (metallic, roughness, normal) for more realistic materials.
`poseMode`	string	No	-	-	-	“, `a-pose`, `t-pose`	Specify the pose mode for the generated model. Accepts ‘a-pose’, ‘t-pose’, or empty string (default).
`shouldRemesh`	boolean	No	`false`	-	-	-	Enable remeshing to improve mesh quality and control polycount. Disable to keep the raw, unprocessed mesh.
`targetPolycount`	number	No	`30000`	100	300000	-	Specify the target number of polygons in the generated model. The actual number of polygons may deviate from the target depending on the complexity of the geometry.

Meshy 7 - Image to 3D

Meshy 7 image-to-3D with higher-fidelity geometry than Meshy 6, optional Ultra mode for finer surface detail, and 2K/4K/8K texturing.

Model ID: model_meshy-7-img23d

Capabilities: img23d

LLM Markdown: https://app.scenario.com/api/models/model_meshy-7-img23d/markdown

Parameter	Type	Required	Default	Min	Max	Allowed Values	Description
`image`	file_array	Yes	-	-	-	-	Upload one image to convert into 3D, or up to four images from multiple angles for higher accuracy.
`ultraMode`	boolean	No	`false`	-	-	-	Enable Ultra generation for higher-fidelity geometry with finer surface detail. Adds cost.
`texturePrompt`	string	No	-	-	-	-	Provide a text description to guide the texturing process. The Style Prompt is only used when no Style Image is provided. If you upload an image, this text prompt will be ignored.
`textureImage`	file	No	-	-	-	-	Upload a reference image to guide the visual style of the generated texture. This will override the Style Prompt. Requires the Texture setting to be enabled (toggle ON).
`shouldTexture`	boolean	No	`true`	-	-	-	Enable texture generation for a fully colored model. Disable to create a plain, untextured mesh.
`textureResolution`	string	No	`2k`	-	-	`2k`, `4k`, `8k`	Base color texture resolution: 2K (2048), 4K (4096), or 8K (8192). Requires Texture to be enabled. At 8K, PBR maps are generated at 4K and no emission map is produced. 8K is only supported with triangle topology when remeshing.
`topology`	string	No	`triangle`	-	-	`triangle`, `quad`	Choose the mesh structure type used for the generated model (e.g., triangles or quads).
`enablePbr`	boolean	No	`true`	-	-	-	Generate advanced PBR maps (metallic, roughness, normal) for more realistic materials. Meshy 7 does not produce an emission map. Requires the Texture setting to be enabled (toggle ON).
`poseMode`	string	No	-	-	-	“, `a-pose`, `t-pose`	Specify the pose mode for the generated model. Accepts ‘A-Pose’, ‘T-Pose’, or empty string (default).
`shouldRemesh`	boolean	No	`false`	-	-	-	Enable remeshing to improve mesh quality and control polycount. Disable to keep the raw, unprocessed mesh (recommended for highest quality on Meshy 7).
`targetPolycount`	number	No	`30000`	100	300000	-	Specify the target number of polygons in the generated model. The actual number of polygons may deviate from the target depending on the complexity of the geometry. Only applies when Remesh is enabled.

Meshy 7 - Multi Image to 3D

Meshy 7 multi-view image-to-3D: combine 1–4 reference images into one 3D asset with optional Ultra mode for finer surface detail and PBR texturing. The first image is the primary (front) view.

Model ID: model_meshy-7-multi-image-to-3d

Capabilities: img23d

LLM Markdown: https://app.scenario.com/api/models/model_meshy-7-multi-image-to-3d/markdown

Parameter	Type	Required	Default	Min	Max	Allowed Values	Description
`image`	file_array	Yes	-	-	-	-	Provide 1–4 images from multiple angles for higher-quality 3D. On Meshy 7 the first image is the primary (front) view; the order of the remaining views does not matter.
`ultraMode`	boolean	No	`false`	-	-	-	Enable Ultra generation for higher-fidelity geometry with finer surface detail, driven by all input views. Adds cost.
`shouldTexture`	boolean	No	`true`	-	-	-	Generate textures for a fully colored model. Disable for an untextured mesh (lower cost).
`enablePbr`	boolean	No	`false`	-	-	-	Generate PBR maps (metallic, roughness, normal) in addition to base color. Meshy 7 does not produce an emission map. Requires texture generation.
`textureResolution`	string	No	`2k`	-	-	`2k`, `4k`, `8k`	Base color texture resolution: 2K (2048), 4K (4096), or 8K (8192). At 8K, PBR maps are generated at 4K and no emission map is produced. 8K is only supported with triangle topology when remeshing.
`texturePrompt`	string	No	-	-	-	-	Optional text to guide texturing (max 600 characters). Cannot be combined with Multi-View Texture Images.
`textureImages`	file_array	No	-	-	-	-	Provide 1-4 images of the same object from different views to guide the texture only. The first image is the primary (front) view. Independent of the geometry Images in both content and count. Requires Texture enabled, and cannot be combined with Texture Prompt.
`topology`	string	No	`triangle`	-	-	`triangle`, `quad`	Mesh topology for the generated model.
`targetPolycount`	number	No	`30000`	100	300000	-	Target polygon count; actual count may vary with geometry complexity.
`savePreRemeshedModel`	boolean	No	`false`	-	-	-	Store the GLB before the remesh phase.
`poseMode`	string	No	-	-	-	“, `a-pose`, `t-pose`	Pose for the generated model: A-Pose, T-Pose, or none.
`imageEnhancement`	boolean	No	`true`	-	-	-	Optimize input images for better results.
`removeLighting`	boolean	No	`true`	-	-	-	Remove highlights and shadows from input images.
`autoSize`	boolean	No	`false`	-	-	-	Estimate real-world scale for the generated model.
`originAt`	string	No	`bottom`	-	-	`bottom`, `center`	Place the model origin at the bottom or center.

Meshy 7 - Retexture

Meshy 7 retexturing with sharper surface detail and cleaner PBR materials. Supports text, image, or multi-view (1–4) style references.

Model ID: model_meshy-7-retexture

Capabilities: 3d23d

LLM Markdown: https://app.scenario.com/api/models/model_meshy-7-retexture/markdown

Parameter	Type	Required	Default	Min	Max	Allowed Values	Description
`model`	file	Yes	-	-	-	-	Upload a GLB file of the 3D model you want to retexture.
`textStylePrompt`	string	No	-	-	-	-	Describe your desired texture style using text. Provide exactly one of Style Prompt, Style Image, or Multi-View Images.
`imageStyle`	file	No	-	-	-	-	Provide a 2D image to guide the texturing process. Provide exactly one of Style Prompt, Style Image, or Multi-View Images.
`multiviewImage`	file_array	No	-	-	-	-	Provide 1–4 images of the same object from different views to drive multi-view texturing (Meshy 7). The first image is the primary (front) view. Provide exactly one of Style Prompt, Style Image, or Multi-View Images.
`enablePbr`	boolean	No	`true`	-	-	-	Generate PBR Maps (metallic, roughness, normal) in addition to the base color.
`textureResolution`	string	No	`2k`	-	-	`2k`, `4k`, `8k`	Base color texture resolution: 2K (2048), 4K (4096), or 8K (8192). At 8K, PBR maps are generated at 4K and no emission map is produced.
`enableOriginalUv`	boolean	No	`true`	-	-	-	Use the model’s existing UV map instead of generating a new one. If no UVs are present, output quality may be lower.

Meshy 7 - Text-to-3D

Meshy 7 text-to-3D with higher-fidelity geometry than Meshy 6, optional Ultra mode for finer surface detail, and 2K/4K/8K texturing.

Model ID: model_meshy-7-txt23d

Capabilities: txt23d

LLM Markdown: https://app.scenario.com/api/models/model_meshy-7-txt23d/markdown

Parameter	Type	Required	Default	Min	Max	Allowed Values	Description
`prompt`	string	Yes	-	-	-	-	Describe the object you want to generate as a 3D model.
`ultraMode`	boolean	No	`false`	-	-	-	Enable Ultra generation for higher-fidelity geometry with finer surface detail. Adds cost.
`texturePrompt`	string	No	-	-	-	-	Provide a text description to guide the texturing process. The Style Prompt is only used when no Style Image is provided. If you upload an image, this text prompt will be ignored.
`textureImage`	file	No	-	-	-	-	Upload a reference image to guide the visual style of the generated texture. This will override the Style Prompt.
`topology`	string	No	`triangle`	-	-	`triangle`, `quad`	Choose the mesh structure type used for the generated model (e.g., triangles or quads).
`textureResolution`	string	No	`2k`	-	-	`2k`, `4k`, `8k`	Base color texture resolution for the refine phase: 2K (2048), 4K (4096), or 8K (8192). At 8K, PBR maps are generated at 4K and no emission map is produced. 8K is only supported with triangle topology when remeshing.
`enablePbr`	boolean	No	`true`	-	-	-	Generate advanced PBR maps (metallic, roughness, normal) for more realistic materials. Meshy 7 does not produce an emission map.
`poseMode`	string	No	-	-	-	“, `a-pose`, `t-pose`	Specify the pose mode for the generated model. Accepts ‘A-Pose’, ‘T-Pose’, or empty string (default).
`shouldRemesh`	boolean	No	`false`	-	-	-	Enable remeshing to improve mesh quality and control polycount. Disable to keep the raw, unprocessed mesh (recommended for highest quality on Meshy 7).
`targetPolycount`	number	No	`30000`	100	300000	-	Specify the target number of polygons in the generated model. The actual number of polygons may deviate from the target depending on the complexity of the geometry. Only applies when Remesh is enabled.

Meshy Animation

Animate a 3D character with Meshy. The model is rigged first, then animated with the selected action.

Model ID: model_meshy-animation

Capabilities: 3d23d

LLM Markdown: https://app.scenario.com/api/models/model_meshy-animation/markdown

Parameter	Type	Required	Default	Min	Max	Allowed Values	Description
`model`	file	Yes	-	-	-	-	The 3D character you want to animate. It’s automatically prepared with a skeleton first, then the chosen animation is applied.
`heightMeters`	number	No	`1.7`	0.1	100	-	The character’s approximate real-world height in meters. This helps scale and prepare the model correctly.
`actionId`	number	Yes	`0`	0	-	-	The animation to apply, given as its ID number from Meshy’s animation library. All action IDs available here: https://docs.meshy.ai/en/api/animation-library
`postProcessOperation`	string	No	-	-	-	“, `change_fps`, `extract_armature`	An optional extra step applied to the finished animation: change its frame rate.
`postProcessFps`	number	No	`30`	-	-	`24`, `25`, `30`, `60`	The target frame rate, used only when the post-process step is set to Change FPS.

Meshy Remesh

Model ID: model_meshy-remesh

Capabilities: 3d23d

LLM Markdown: https://app.scenario.com/api/models/model_meshy-remesh/markdown

Parameter	Type	Required	Default	Min	Max	Allowed Values	Description
`model`	file	Yes	-	-	-	-	Upload a GLB file of the 3D model you want to remesh.
`topology`	string	No	`triangle`	-	-	`triangle`, `quad`	Choose the mesh structure type used for the generated model. For Quad, choose output format ‘obj’
`targetPolycount`	number	No	`30000`	100	300000	-	Set the approximate number of polygons for your 3D model. Higher values increase detail, while lower values create simpler meshes.
`resizeHeight`	number	No	`0`	0	10000	-	Adjust the model’s height in meters. Set to 0 to keep the original scale.
`originAt`	string	No	`empty`	-	-	`empty`, `bottom`, `center`	Define where the model’s origin point is positioned. Leave empty to keep the default origin.

Meshy Retexture

Retexture your 3D model with Meshy’s AI re texturing capabilities.

Model ID: model_meshy-retexture

Capabilities: 3d23d

LLM Markdown: https://app.scenario.com/api/models/model_meshy-retexture/markdown

Parameter	Type	Required	Default	Min	Max	Allowed Values	Description
`model`	file	Yes	-	-	-	-	Upload a GLB file of the 3D model you want to retexture.
`textStylePrompt`	string	No	-	-	-	-	Describe your desired texture style of the object using text.
`imageStyle`	file	No	-	-	-	-	Provide a 2d image to guide the texturing process.
`enablePbr`	boolean	No	`false`	-	-	-	Generate PBR Maps (metallic, roughness, normal) in addition to the base color.
`textureResolution`	string	No	`2k`	-	-	`2k`, `4k`, `8k`	Base color texture resolution: 2K (2048), 4K (4096), or 8K (8192). 4K/8K take effect on Meshy 6; other models ignore them. At 8K, PBR maps are generated at 4K and no emission map is produced.
`enableOriginalUv`	boolean	No	`true`	-	-	-	Use the model’s existing UV map instead of generating a new one. If no UVs are present, output quality may be lower.
`removeLighting`	boolean	No	`true`	-	-	-	Removes highlights and shadows from the base color texture, producing a cleaner result that works better under custom lighting setups.

Meshy Rigging

Model ID: model_meshy-rigging

Capabilities: 3d23d

LLM Markdown: https://app.scenario.com/api/models/model_meshy-rigging/markdown

Parameter	Type	Required	Default	Min	Max	Allowed Values	Description
`model`	file	Yes	-	-	-	-	The 3D model (GLB)
`heightMeters`	number	No	`1.7`	0.1	100	-	The approximate height of the character model in meters. This aids in scaling and rigging accuracy. It must be a positive number.
`textureImage`	file	No	-	-	-	-	Model’s base color texture image.

Meshy T2 Smart Topology

Meshy Smart Topology (meshy-t2) generates clean, production-ready 3D meshes from text or images with native polycount control and separated parts — no remesh pass.

Model ID: model_meshy-smart-topology

Capabilities: txt23d, img23d

LLM Markdown: https://app.scenario.com/api/models/model_meshy-smart-topology/markdown

Parameter	Type	Required	Default	Min	Max	Allowed Values	Description
`prompt`	string	No	-	-	-	-	Describe the object to generate. Text route; mutually exclusive with Image.
`image`	file_array	No	-	-	-	-	Single input image to reconstruct. Image route; mutually exclusive with Prompt. Smart Topology has no multi-view model.
`texturePrompt`	string	No	-	-	-	-	A text description to guide the model’s surface look. Used only when no Style Image is provided. If you upload one, this text is ignored.
`textureImage`	file	No	-	-	-	-	A reference image to guide the surface look of the model. Overrides the Style Prompt. Requires Texture to be turned on.
`shouldTexture`	boolean	No	`true`	-	-	-	Generate a texture. Off returns the untextured mesh — on the text route that skips the refine phase.
`textureResolution`	string	No	`2k`	-	-	`2k`, `4k`, `8k`	Base color texture resolution: 2K (2048), 4K (4096), or 8K (8192). Honored on both the text and image routes. Requires Texture to be turned on. Unset leaves Meshy’s 2K default. At 8K, PBR maps are generated at 4K and no emission map is produced.
`enablePbr`	boolean	No	`false`	-	-	-	Adds realistic material detail (metallic, roughness, normal). Requires Texture to be turned on.
`poseMode`	string	No	-	-	-	“, `a-pose`, `t-pose`	For characters, generates the model in a standard reference pose. A-Pose (arms angled down) and T-Pose (arms straight out) are both common starting points for animation. Leave empty for no specific pose.
`targetPolycount`	number	No	`4000`	100	15000	-	Face count of the generated mesh. Smart Topology generates directly at this count with no remesh.

Meshy Text to Motion

Generate a standalone character motion clip from a text prompt. Prime outputs FBX; Swift outputs BVH. Retarget the clip onto your own rigged character.

Model ID: model_meshy-text-to-motion

Capabilities: txt23d

LLM Markdown: https://app.scenario.com/api/models/model_meshy-text-to-motion/markdown

Parameter	Type	Required	Default	Min	Max	Allowed Values	Description
`prompt`	string	Yes	-	-	-	-	Describe the motion to generate — for example, “a character waving” or “a zombie shambling forward”.
`duration`	number	No	`3`	2	10	-	Target duration of the motion clip in seconds. Must be between 2 and 10, in steps of 0.5.

Meshy UV Unwrap

Generate UV maps for a 3D model with Meshy. Produces a UV white-model GLB ready for texturing.

Model ID: model_meshy-uv-unwrap

Capabilities: 3d23d

LLM Markdown: https://app.scenario.com/api/models/model_meshy-uv-unwrap/markdown

Parameter	Type	Required	Default	Min	Max	Allowed Values	Description
`model`	file	Yes	-	-	-	-	Upload a GLB file of the 3D model you want to UV unwrap. Models above 44,000 faces are rejected — run Meshy Remesh first to reduce polygon count if needed.