fal3DAvailable now

fal-ai/meshy/v6/multi-image-to-3d

fal-ai/meshy/v6/multi-image-to-3d is a 3D tool from fal that runs in the background and returns 3D models and images. Pay as you go, with one API key.

Pricing

$1.56 per model with texture ($1.04 without). Rigging: $0.26. Rigging with animation: $0.416.

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
500 MB
Largest output
5 GB
Outputs per run
24

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.

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. Requires should_texture to be true.

texture_image_urlURL or file—

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

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.

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.

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