# Meshy 6 Preview Text to 3D

Generate 3D models from text with Meshy 6 Preview Text to 3D from fal through one Spiral API key. Creates a 3D model from a text description, with optional textures, PBR maps, quad or triangle topology, rigging and animation. 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: 2025-10-06
- Tool id: `fal` / `fal-ai/meshy/v6-preview/text-to-3d`
- Page: https://spiral.ai/tools/fal/fal-ai/meshy/v6-preview/text-to-3d

## Pricing

$1.56 per model ($1.04 in preview mode). Rigging: $0.26. Rigging with animation: $0.416.

## 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 |
| --- | --- | --- | --- | --- |
| `prompt` (required) | text |  | — | Describe what kind of object the 3D model is. Maximum 600 characters. |
| `mode` | one of | preview, full | full | Generation mode. 'preview' returns untextured geometry only, 'full' returns textured model (preview + refine). |
| `seed` | number (whole) |  | — | Seed for reproducible results. Same prompt and seed usually generate the same result. |
| `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. 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. |
| `should_remesh` | true or false |  | true | Whether to enable the remesh phase. When false, returns unprocessed triangular mesh. |
| `symmetry_mode` | one of | off, auto, on | auto | Controls symmetry behavior during model generation. |
| `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. |
| `enable_prompt_expansion` | true or false |  | false | Whether to enable prompt expansion. This will use a large language model to expand the prompt with additional details while maintaining the original meaning. |
| `texture_prompt` | text |  | — | Additional text prompt to guide the texturing process (only used in 'full' mode) |
| `texture_image_url` | URL or file |  | — | 2D image to guide the texturing process (only used in 'full' mode) |
| `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. |
| `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. |

## 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": "fal-ai/meshy/v6-preview/text-to-3d",
    "input": {
      "prompt": "A rustic, antique wooden treasure chest with a curved, domed lid, constructed from weathered, dark brown planks exhibiting prominent wood grain and subtle…"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=fal-ai%2Fmeshy%2Fv6-preview%2Ftext-to-3d

## Common questions

### Meshy 6 Preview Text to 3D

**How much does Meshy 6 Preview Text to 3D cost?**

$1.56 per model ($1.04 in preview mode). 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 Text to 3D through an API?**

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

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

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

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

