← All models
V7 Image to 3D
v7
3D generationby meshy
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
- image
Pricing
- Price
- 0.00875 cr / second
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_urlrequired | 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, lowpoly | Type of 3D mesh generation. 'standard' produces a regular high-detail mesh; 'lowpoly' produces a low-poly mesh optimized for cleaner polygons. When set to 'lowpoly', the remesh controls (topology, target_polycount, should_remesh) are ignored by Meshy. |
| ultra_mode | boolean | Enable higher-fidelity geometry with finer surface detail. |
| 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. |
| 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 |
| 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 |
| 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. |
| 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. |
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. |