infery
← All models

Meshy T2 Text to 3D

t2

3D generationby Meshy

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

FieldTypeDescription
modestringenum: preview, fullGeneration 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.
promptstringDescribe what kind of object the 3D model is. Maximum 600 characters.
pose_modestringenum: 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_pbrbooleanGenerate PBR Maps (metallic, roughness, normal) in addition to base color.
texture_modelstringenum: meshy-7.1, meshy-n1Model 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_riggingbooleanAutomatically 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_fingersbooleanRig the character's fingers. Works with any skeleton template. Only used when enable_rigging is true.
enable_animationbooleanApply an animation preset to the rigged model. Requires enable_rigging to be true.
target_polycountintegerTarget 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_idintegerAnimation 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_checkerbooleanIf set to true, input data will be checked for safety before processing.
rigging_height_metersnumberApproximate height of the character in meters. Only used when enable_rigging is true.
enable_prompt_expansionbooleanWhether to enable prompt expansion. This will use a large language model to expand the prompt with additional details while maintaining the original meaning.
image_urlstringImage 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_texturebooleanWhether to generate textures

Output

FieldTypeDescription
seed—The seed used for generation
promptstringThe 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_urlsarrayArray 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.