fal-3d

分类: 数据与AI | 上传者: fal-ai-community | 下载: 0 | 版本: v1.0（最新）

从文本或图像生成 3D 模型。当用户请求“创建 3D 模型”、“文本转 3D”、“图像转 3D”、“3D 生成”、“生成网格”、“3D 资源”时使用。

更新日志: Source: GitHub https://github.com/fal-ai-community/skills

目录结构

当前层级: tree/main/skills/claude.ai/fal-3d/

📁 scripts/
- 📄 generate-3d.sh 2.5 KB
📄 SKILL.md 2.0 KB

SKILL.md

---
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"
  }
}
```

登录后下载/点赞/收藏 ❤ 86 | ★ 0

fal-3d

目录结构

SKILL.md

举报内容

提示