← All models
Meshy T2 is Meshy's faster Smart Topology model. It generates a clean, triangle-only 3D mesh with natively separated parts from a text prompt, with a target polycount of up to 15,000 triangles (default 4,000). Preview mode returns the untextured mesh, and full mode textures it with Meshy 7.1; it generates faster than Meshy T2.5, which suits low-poly assets.
Details
- Accepts
- text + image
Pricing
- Price
- 100 cr / request
Prices in credits (1 credit = $0.01).
Data schema
Input
| Field | Type | Description |
|---|---|---|
| mode | stringenum: preview, full | Generation mode. 'preview' returns untextured Smart Topology geometry only, 'full' also textures it (preview + refine). |
| seed | — | Seed for reproducible results. Same prompt and seed usually generate the same result. |
| prompt | string | Describe what kind of object the 3D model is. Maximum 600 characters. |
| pose_mode | stringenum: a-pose, t-pose, | Pose mode for the generated model. 'a-pose' generates an A-pose, 't-pose' generates a T-pose, empty string for no specific pose. |
| enable_pbr | boolean | Generate PBR Maps (metallic, roughness, normal) in addition to base color. |
| texture_model | stringenum: meshy-7.1, meshy-n1 | Model for the texturing (refine) step, only used in 'full' mode. meshy-n1 makes a 2K base color texture from texture_image_url, which it requires; it rejects texture_prompt and enable_pbr. |
| 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. |
| texture_prompt | — | Additional text prompt to guide the texturing process (only used in 'full' mode). Maximum 800 characters. Cannot be combined with texture_image_url. |
| include_fingers | boolean | Rig the character's fingers. Works with any skeleton template. Only used when enable_rigging is true. |
| enable_animation | boolean | Apply an animation preset to the rigged model. Requires enable_rigging to be true. |
| target_polycount | integer | Target number of triangles in the generated model. Smart Topology output is triangle-only. |
| skeleton_template | — | Skeleton template for the rig. Animations made from the rig use the same skeleton. Leave unset for Meshy's default skeleton (meshyrig). Some models can only be rigged on meshyrig without fingers; those requests fail with a 422. Only used when enable_rigging is true. |
| texture_image_url | — | 2D image to guide the texturing process (only used in 'full' mode). Cannot be combined with texture_prompt. |
| animation_action_id | integer | Animation preset ID from Meshy's library. Only used when enable_animation is true; in that case it must be in [0, 696]. See https://docs.meshy.ai/en/api/animation-library for available action IDs. |
| enable_safety_checker | boolean | If set to true, input data will be checked for safety before processing. |
| rigging_height_meters | number | Approximate height of the character in meters. Only used when enable_rigging is true. |
| enable_prompt_expansion | boolean | Whether to enable prompt expansion. This will use a large language model to expand the prompt with additional details while maintaining the original meaning. |
| image_url | string | Image URL or base64 data URI for 3D model creation. Supports .jpg, .jpeg, and .png formats. Also supports AVIF and HEIF formats which will be automatically converted. |
| should_texture | boolean | Whether to generate textures |
Output
| Field | Type | Description |
|---|---|---|
| seed | — | The seed used for generation |
| prompt | string | The text prompt used for generation |
| model_glb | — | Generated 3D object in GLB format. |
| thumbnail | — | Preview thumbnail of the generated model |
| model_urls | — | URLs for different 3D model formats |
| rig_task_id | — | Rigging task ID. Only present when enable_rigging is true. |
| texture_urls | array | Array of texture file objects |
| actual_prompt | — | The actual prompt used if prompt expansion was enabled |
| animation_fbx | — | Animated 3D model in FBX format. Only present when enable_animation is true. |
| animation_glb | — | Animated 3D model in GLB format. Only present when enable_animation is true. |
| basic_animations | — | Basic walking and running animations. Only present when enable_rigging is true. |
| rigged_character_fbx | — | Rigged character in FBX format. Only present when enable_rigging is true. |
| rigged_character_glb | — | Rigged character in GLB format. Only present when enable_rigging is true. |