← All models
V7 Multi Image to 3D
v7-multi-image-to-3d
3D generationby meshy
econstructs a high-fidelity textured 3D model from multiple angle views of one object, with game-ready topology and polygon control
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. |
| 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. Requires should_texture to be true. |
| image_urlsrequired | array | 1 to 4 images for 3D model creation. All images should depict the same object from different angles. Supports .jpg, .jpeg, .png formats, and AVIF/HEIF which will be automatically converted. If more than 4 images are provided, only the first 4 will be used. |
| 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. When false, returns triangular mesh ignoring topology and target_polycount. |
| symmetry_mode | stringenum: off, auto, on | Controls symmetry behavior during model generation. |
| 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. False provides mesh without textures for 5 credits, True adds texture generation for additional 10 credits. |
| texture_prompt | — | Text prompt to guide the texturing process. Requires should_texture to be 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 |
| texture_image_url | — | 2D image to guide the texturing process. Requires should_texture to be true. |
| 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 |
| 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. |