Spiral gives your agent every tool with one account. Browse the tools →

fal3DAvailable nowReleased 2026-09-19

Meshy 7.1 Multi-Image to 3D

meshy/v7.1/multi-image-to-3d

Turn images into 3D models with Meshy 7.1 Multi-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 one to four views of the same object, with optional textures and PBR maps. It runs in the background and returns 3D models and images. Pay as you go, with no subscription.

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

Runs
In the background
Returns
3d, image
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

FieldKindDefaultDescription
image_urls requiredURLs or files—

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.

topologyone of
quad, triangle
triangle

Specify the topology of the generated model. Quad for smooth surfaces, Triangle for detailed geometry.

target_polycountnumber (whole)
100 to 300000
30000

Target number of polygons in the generated model

symmetry_modeone of
off, auto, on
auto

Controls symmetry behavior during model generation.

should_remeshtrue or falsetrue

Whether to enable the remesh phase. When false, returns triangular mesh ignoring topology and target_polycount.

should_texturetrue or falsetrue

Whether to generate textures.

texture_modelone of
meshy-7, meshy-n1
—

Model that textures the generated mesh from several views, 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, Meshy textures from texture_image_urls or texture_image_url, or from the input images when neither is set.

enable_pbrtrue or falsefalse

Generate PBR Maps (metallic, roughness, normal) in addition to base color. Requires should_texture to be true.

is_a_t_posetrue or falsefalse

Deprecated: use pose_mode instead. When true, generates a T-pose model.

pose_modeone 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_prompttext—

Text prompt to guide the texturing process. Maximum 800 characters. Requires should_texture to be true.

texture_image_urlURL or file—

2D image to guide the texturing process. Requires should_texture to be true.

texture_image_urlslist—

1 to 4 views of the object that guide only the texture (the first is the front view); independent of image_urls. Requires the Meshy 7 or Meshy N1 texture model (the v7/v7.1 endpoints, or texture_model meshy-7 or meshy-n1). Cannot be combined with texture_image_url, texture_prompt, or should_texture false.

enable_riggingtrue or falsefalse

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_metersnumber1.7

Approximate height of the character in meters. Only used when enable_rigging is true.

skeleton_templateone 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_fingerstrue or falsefalse

Rig the character's fingers. Works with any skeleton template. Only used when enable_rigging is true.

enable_animationtrue or falsefalse

Apply an animation preset to the rigged model. Requires enable_rigging to be true.

animation_action_idnumber (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_resolutionone of
standard, 2k
—

Geometry resolution. Multi-image generation does not support 4k.

Same request in code

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/multi-image-to-3d",
    "input": {
      "image_urls": [
        "<image_urls>"
      ]
    }
  }'

Frequently asked questions

How much does Meshy 7.1 Multi-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 Multi-Image to 3D through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "meshy/v7.1/multi-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 Multi-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 Multi-Image to 3D?

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