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
./scripts/generate-3d.sh --image-url "https://example.com/object.jpg" --model fal-ai/hunyuan3d-v3/image-to-3d
Text to 3D
./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:
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
{ "mesh": { "url": "https://fal.media/files/.../model.glb", "content_type": "model/gltf-binary", "file_name": "model.glb" } }