---
name: fal-3d
description: Generate 3D models from text or images. Use when the user requests "Create 3D model", "Text to 3D", "Image to 3D", "3D generation", "Generate mesh", "3D asset".
metadata:
  author: fal-ai
  version: "1.0.0"
---

# fal-3d

Generate 3D models (GLB/OBJ/PLY) from text descriptions or images using fal.ai.

## Scripts

| Script | Purpose |
|--------|---------|
| `generate-3d.sh` | Generate a 3D model from text or image |

## Usage

### Image to 3D
```bash
./scripts/generate-3d.sh --image-url "https://example.com/object.jpg" --model fal-ai/hunyuan3d-v3/image-to-3d
```

### Text to 3D
```bash
./scripts/generate-3d.sh --prompt "A medieval sword with ornate handle" --model fal-ai/meshy/v6/text-to-3d
```

## Arguments

| Argument | Description | Required |
|----------|-------------|----------|
| `--image-url` | URL of image to convert to 3D | Yes (or --prompt) |
| `--prompt` / `-p` | Text description for text-to-3D | Yes (or --image-url) |
| `--model` / `-m` | Model endpoint | No (default: fal-ai/hunyuan3d-v3/image-to-3d) |
| `--param` | Extra param as key=value (repeatable) | No |

## Finding Models

To discover the best and latest 3D generation models, use the search API:

```bash
# Search for image-to-3D models
bash /mnt/skills/user/fal-generate/scripts/search-models.sh --category "image-to-3d"

# Search for text-to-3D models
bash /mnt/skills/user/fal-generate/scripts/search-models.sh --query "text to 3d"
```

Or use the `search_models` MCP tool with relevant keywords like "3d", "mesh", "image-to-3d".

## Tips

- For best results from images: use a clear photo with a single object on a plain background
- Remove background first if needed (use fal-image-edit or fal-generate with birefnet)
- Simple, well-defined objects work best — complex scenes don't reconstruct well yet
- 3D generation takes 1-5 minutes — jobs use the queue API

## Output Format
```json
{
  "mesh": {
    "url": "https://fal.media/files/.../model.glb",
    "content_type": "model/gltf-binary",
    "file_name": "model.glb"
  }
}
```