fal-3d

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」などの関連キーワードを使用します。

ヒント

• 画像から最良の結果を得るには、無地の背景に単一のオブジェクトが写った鮮明な写真を使用します
• 必要に応じて、先に背景を削除します（birefnet を使用して fal-image-edit または fal-generate を実行します）
• シンプルで輪郭がはっきりしたオブジェクトが最適です。複雑なシーンはまだうまく再構成できません
• 3D 生成には 1～5 分かかります。ジョブにはキュー API を使用します

出力形式

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