# Meshy V7.1

Makes a 3D model out of words or out of one to four photographs of the same object, with colour and surface on it. It can rig the model as a poseable character and play one of 697 built-in movements. The file it makes stands on the 3D Scene Composer.

Model id: `meshy-v7-1`
Type: 3D
Made by: Meshy
Inputs: Text, First frame, References
Updated: Oct 12, 2026

## Pricing

| Setting | MiniAPI | fal | Difference |
| --- | ---: | ---: | ---: |
| + animation | $0.132 / 3D model | $0.12 | +10% |
| + rigging | $0.22 / 3D model | $0.20 | +10% |
| no texture | $0.88 / 3D model | $0.80 | +10% |
| textured | $1.32 / 3D model | $1.20 | +10% |

You are not charged for a job that fails.

## Parameters

| Name | Required | Values | Default | Description |
| --- | --- | --- | --- | --- |
| `prompt` | For text-to-3d | text |  | What to make, in plain words. Only with text-to-3d. |
| `image_url` | For image-to-3d | https URL |  | A picture to start from. We fetch it and keep a copy for the job. Only with image-to-3d. |
| `texture_image_url` | No | https URL |  | 2D image to guide the texturing process |
| `image_urls` | For multi-image-to-3d | https URLs |  | Pictures to use as references. Only with multi-image-to-3d. |
| `model_type` | No | standard, lowpoly, smart-topology, smart-topology-t2 | standard | Type of 3D mesh generation. 'standard' produces a regular high-detail mesh; 'lowpoly' produces a low-poly mesh optimized for cleaner polygons; 'smart-topology' (Smart Topology T2.5) and 'smart-topology-t2' (Smart Topology T2) produce clean, triangle-only meshes with natively separated parts — T2.5 has sharper detail, T2 is faster. When set to 'lowpoly', the remesh controls (topology, target_polycount, should_remesh) are ignored by Meshy. |
| `topology` | No | quad, triangle | triangle | Specify the topology of the generated model. Quad for smooth surfaces, Triangle for detailed geometry. |
| `target_polycount` | No | 100 to 300000 | 30000 | Target number of polygons in the generated model. When model_type is a smart topology option and this is left unset, that model's default is used instead (15,000 for T2.5, 4,000 for T2); the maximum is 30,000 for T2.5 and 15,000 for T2. |
| `symmetry_mode` | No | off, auto, on | auto | Controls symmetry behavior during model generation. Off disables symmetry, Auto determines it automatically, On enforces symmetry. |
| `should_remesh` | No | true, false | true | Whether to enable the remesh phase |
| `should_texture` | No | true, false | true | Whether to generate textures |
| `enable_pbr` | No | true, false | false | Generate PBR Maps (metallic, roughness, normal) in addition to base color |
| `pose_mode` | No | 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. |
| `texture_prompt` | No | text |  | Text prompt to guide the texturing process |
| `enable_rigging` | No | true, false | false | 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. |
| `rigging_height_meters` | No | number | 1.7 | Approximate height of the character in meters. Only used when enable_rigging is true. |
| `enable_animation` | No | true, false | false | Apply an animation preset to the rigged model. Requires enable_rigging to be true. |
| `animation_action_id` | No | integer | 92 | 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. |
| `geometry_resolution` | No | standard, 2k, 4k |  | Geometry resolution. 4k is only available with Meshy-7.1. |
| `mode` | No | preview, full | full | Generation mode. 'preview' returns untextured geometry only, 'full' returns textured model (preview + refine). Only with text-to-3d. |
| `enable_prompt_expansion` | No | true, false | false | Let the model add detail to a short prompt. Only with text-to-3d. |
| `is_a_t_pose` | No |  |  | Deprecated: use pose_mode instead. When true, generates a T-pose model. |
| `ultra_mode` | No |  |  | Deprecated: use geometry_resolution='2k'. If both fields are provided, geometry_resolution takes precedence. |
| `seed` | No | integer |  | The same seed with the same settings gives a similar result. Leave it out for a random one. Only with text-to-3d. |

## Quickstart

```bash
curl -X POST "https://api.minicut.ai/v1/queue/meshy-v7-1" \
  -H "Authorization: Key $MINIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"a red fox runs through snow at dawn"}'
```

```json
{
  "request_id": "0192f3a4-5b6c-7d8e-9f01-23456789abcd",
  "status": "IN_QUEUE",
  "queue_position": 0,
  "status_url": "https://api.minicut.ai/v1/queue/meshy-v7-1/requests/0192f3a4-5b6c-7d8e-9f01-23456789abcd/status",
  "response_url": "https://api.minicut.ai/v1/queue/meshy-v7-1/requests/0192f3a4-5b6c-7d8e-9f01-23456789abcd",
  "cancel_url": "https://api.minicut.ai/v1/queue/meshy-v7-1/requests/0192f3a4-5b6c-7d8e-9f01-23456789abcd/cancel",
  "price": "1.320000",
  "currency": "USD"
}
```

Page: https://api.minicut.ai/models/meshy-v7-1
API reference: https://api.minicut.ai/docs/api