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

fal3DAvailable nowReleased 2025-10-06

Meshy 6 Preview Image to 3D

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

Turn images into 3D models with Meshy 6 Preview Image to 3D from fal through one Spiral API key. Turns a single image into a textured 3D model, with quad or triangle topology, PBR maps and optional humanoid rigging. It runs in the background and returns 3D models and images. Pay as you go, with no subscription.

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
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
image_url requiredURL 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_typeone of
standard
standard

Type of 3D mesh generation. Only 'standard' is supported; Smart Topology has its own endpoints (/t2.5 and /t2).

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. 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_modeone of
off, auto, on
auto

Controls symmetry behavior during model generation. Off disables symmetry, Auto determines it automatically, On enforces symmetry.

should_remeshtrue or falsetrue

Whether to enable the remesh phase

should_texturetrue or falsetrue

Whether to generate textures

enable_pbrtrue or falsefalse

Generate PBR Maps (metallic, roughness, normal) in addition to base color

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

texture_image_urlURL or file—

2D image to guide the texturing process

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-preview/image-to-3d",
    "input": {
      "image_url": "https://v3b.fal.media/files/b/zebra/3osHJDI8IZ2wl6sGtEUeB_image.png"
    }
  }'

Frequently asked questions

How much does Meshy 6 Preview Image to 3D cost?

$1.56 per model with texture ($1.04 without). Rigging: $0.26. Rigging with animation: $0.416. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Meshy 6 Preview Image to 3D through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/meshy/v6-preview/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 6 Preview Image to 3D?

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

Can my AI agent use Meshy 6 Preview Image to 3D?

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