mcpField
F
fal-3d

fal-3d

github.com/fal-ai-community创意与媒体258110 次安装24 周前更新
代码仓库

关于 fal-3d

fal-3d 是使用 fal.ai 根据文本描述或图像生成 3D 模型的命令行技能，支持 GLB、OBJ 和 PLY 格式。用户可选择模型端点，README 也介绍了通过搜索查找生成模型。

主要功能

  1. 01根据文本生成 3D 模型
  2. 02将图像转换为 3D 模型
  3. 03输出 GLB、OBJ 和 PLY 格式
  4. 04选择模型端点
  5. 05传入额外模型参数

适用场景

  1. 01根据描述创建 3D 对象
  2. 02根据物体图像制作 3D 模型
  3. 03查找文本转 3D 或图像转 3D 模型

MCP 相关

README 提及可使用 `search_models` MCP 工具发现 3D 生成模型。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/fal-ai-community/skills --skill fal-3d

安装后在 Claude Code 中输入/fal-3d确认已加载。

附带文件scripts/generate-3d.sh

详细介绍

fal-3d

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

脚本

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

用法

图像转 3D
./scripts/generate-3d.sh --image-url "https://example.com/object.jpg" --model fal-ai/hunyuan3d-v3/image-to-3d
文本转 3D
./scripts/generate-3d.sh --prompt "A medieval sword with ornate handle" --model fal-ai/meshy/v6/text-to-3d

参数

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

查找模型

若要发现最佳且最新的 3D 生成模型，请使用搜索 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"

或者，使用 search_models MCP 工具，并输入相关关键词，例如 "3d"、"mesh"、"image-to-3d"。

提示

  • 若要获得最佳图像生成效果：使用主体清晰、背景纯色且只包含单个物体的照片
  • 如果需要，请先移除背景（使用 fal-image-edit 或搭配 birefnet 的 fal-generate）
  • 简单、轮廓清晰的物体效果最佳 — 目前还无法很好地重建复杂场景
  • 3D 生成需要 1-5 分钟 — 任务使用队列 API

输出格式

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

评论

支持 Markdown