fal-3d

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

fal-3d

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

使用fal.ai从文本描述或图像生成3D模型（GLB/OBJ/PLY格式）。

Scripts

脚本

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

脚本	用途
`generate-3d.sh`	从文本或图像生成3D模型

Usage

使用方法

Image to 3D

图像转3D

bash

./scripts/generate-3d.sh --image-url "https://example.com/object.jpg" --model fal-ai/hunyuan3d-v3/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

文本转3D

bash

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

bash

./scripts/generate-3d.sh --prompt "一把带有华丽手柄的中世纪剑" --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

参数	描述	是否必填
`--image-url`	用于转换为3D的图像URL	是（或提供--prompt）
`--prompt` / `-p`	文本转3D的文本描述	是（或提供--image-url）
`--model` / `-m`	模型端点	否（默认值：fal-ai/hunyuan3d-v3/image-to-3d）
`--param`	额外参数，格式为key=value（可重复添加）	否

Finding Models

查找模型

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

bash

undefined

如需查找最佳的最新3D生成模型，可使用搜索API：

bash

undefined

Search for image-to-3D models

搜索图像转3D模型

bash /mnt/skills/user/fal-generate/scripts/search-models.sh --category "image-to-3d"

Search for text-to-3D models

搜索文本转3D模型

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".

bash /mnt/skills/user/fal-generate/scripts/search-models.sh --query "text to 3d"


或者使用`search_models` MCP工具，搭配「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

如使用图像生成想要获得最佳效果：请使用背景简洁、仅包含单个物体的清晰照片
如有需要可先移除背景（使用fal-image-edit或者搭配birefnet的fal-generate）
简单、定义清晰的物体效果最佳——目前复杂场景的重建效果还不理想
3D生成耗时1-5分钟——任务会通过队列API执行

Output Format

输出格式

json

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

json

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