# Meshy 7.1 Image to 3D

Turn images into 3D models with Meshy 7.1 Image to 3D from fal through one Spiral API key. Meshy 7.1 is the latest standard model from Meshy. It generates 3D models from a single image, with optional textures and PBR maps. It runs in the background and returns 3D models and images. Pay as you go, with no subscription.

- Provider: fal
- Category: 3D
- Runs: In the background
- Returns: 3d, image
- Released: 2026-09-19
- Tool id: `fal` / `meshy/v7.1/image-to-3d`
- Page: https://spiral.ai/tools/fal/meshy/v7.1/image-to-3d

## Pricing

`should_texture`: false $1.04, true $1.56 per model. `enable_rigging` adds $0.26 per model. `enable_rigging` and `enable_animation` add $0.156 per model.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 30 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `image_url` (required) | URL or file |  | — | 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. |
| `model_type` | one of | standard | standard | Type of 3D mesh generation. Only 'standard' is supported; Smart Topology has its own endpoints (/t2.5 and /t2). |
| `topology` | one of | quad, triangle | triangle | Specify the topology of the generated model. Quad for smooth surfaces, Triangle for detailed geometry. |
| `target_polycount` | number (whole) | 100 to 300000 | 30000 | Target number of polygons in the generated model. |
| `symmetry_mode` | one of | off, auto, on | auto | Controls symmetry behavior during model generation. Off disables symmetry, Auto determines it automatically, On enforces symmetry. |
| `should_remesh` | true or false |  | true | Whether to enable the remesh phase |
| `should_texture` | true or false |  | true | Whether to generate textures |
| `texture_model` | one of | meshy-7, meshy-n1, meshy-6-lite | — | 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. With meshy-n1, texture_image_url is used as the front view, or the input image when it is unset. |
| `enable_pbr` | true or false |  | false | Generate PBR Maps (metallic, roughness, normal) in addition to base color |
| `is_a_t_pose` | true or false |  | false | Deprecated: use pose_mode instead. When true, generates a T-pose model. |
| `pose_mode` | one of | 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` | text |  | — | Text prompt to guide the texturing process. Maximum 800 characters. |
| `texture_image_url` | URL or file |  | — | 2D image to guide the texturing process |
| `enable_rigging` | true or 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` | number |  | 1.7 | Approximate height of the character in meters. Only used when enable_rigging is true. |
| `skeleton_template` | one of | mixamo, ue5_mannequin, unity_humanoid, maya_human_ik, blender_rigify_basic_human, max_biped, cc5_hd_neutral_base, daz_genesis9, meshyrig | — | 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. |
| `include_fingers` | true or false |  | false | Rig the character's fingers. Works with any skeleton template. Only used when enable_rigging is true. |
| `enable_animation` | true or false |  | false | Apply an animation preset to the rigged model. Requires enable_rigging to be true. |
| `animation_action_id` | number (whole) |  | 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. See https://docs.meshy.ai/en/api/animation-library for available action IDs. |
| `geometry_resolution` | one of | standard, 2k, 4k | — | Geometry resolution. 4k is only available with Meshy-7.1. |
| `ultra_mode` | true or false |  | false | Deprecated: use geometry_resolution='2k'. If both fields are provided, geometry_resolution takes precedence. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "meshy/v7.1/image-to-3d",
    "input": {
      "image_url": "https://v3b.fal.media/files/b/zebra/3osHJDI8IZ2wl6sGtEUeB_image.png"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=meshy%2Fv7.1%2Fimage-to-3d

## Common questions

### Meshy 7.1 Image to 3D

**How much does Meshy 7.1 Image to 3D cost?**

`should_texture`: false $1.04, true $1.56 per model. `enable_rigging` adds $0.26 per model. `enable_rigging` and `enable_animation` add $0.156 per model. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Meshy 7.1 Image to 3D through an API?**

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "meshy/v7.1/image-to-3d"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with fal to use Meshy 7.1 Image to 3D?**

No. Spiral runs it on its own fal account and charges your Spiral balance.

**Can my AI agent use Meshy 7.1 Image to 3D?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

