← All models
Turns a single image into a fully textured, PBR-ready 3D mesh with complete geometry, in game-ready Smart Topology at a target polygon count
Details
- Accepts
- text + image
Pricing
- Price
- 100 cr / request
Prices in credits (1 credit = $0.01).
Data schema
Input
| Field | Type | Description |
|---|---|---|
| topology | stringenum: quad, triangle | Specify the topology of the generated model. Quad for smooth surfaces, Triangle for detailed geometry. |
| 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. |
| 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 |
| model_type | stringenum: standard | Type of 3D mesh generation. Only 'standard' is supported; Smart Topology has its own endpoints (/t2.5 and /t2). |
| ultra_mode | boolean | Deprecated: use geometry_resolution='2k'. If both fields are provided, geometry_resolution takes precedence. |
| 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 |
| symmetry_mode | stringenum: off, auto, on | Controls symmetry behavior during model generation. Off disables symmetry, Auto determines it automatically, On enforces symmetry. |
| texture_model | — | Model that textures the generated mesh, in the same task. Leave unset to use the endpoint model's default texture model. Ignored when should_texture is false. meshy-n1 makes a 2K base color texture from reference images only: it rejects texture_prompt, enable_pbr, and quad topology with remeshing. W… |
| 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. |
| should_texture | boolean | Whether to generate textures |
| texture_prompt | — | Text prompt to guide the texturing process. Maximum 800 characters. |
| 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 polygons in the generated model. |
| 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 |
| 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] (``0`` is the "Idle" preset) and is otherwise rejected with a 422. See https://docs.meshy.ai/en/api/animation-library for available action IDs. |
| geometry_resolution | — | Geometry resolution. Meshy-7 supports standard and 2k. |
| 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. |
| mode | stringenum: preview, full | Generation mode. 'preview' returns untextured geometry only, 'full' returns textured model (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. |
| 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. |
Output
| Field | Type | Description |
|---|---|---|
| seed | — | The seed used for generation (if available) |
| 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, matching Meshy API structure |
| 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. |