Skip to main content
Endpoint: POST https://fal.run/fal-ai/hunyuan-3d/v3.1/rapid/image-to-3d Endpoint ID: fal-ai/hunyuan-3d/v3.1/rapid/image-to-3d

Try it in the Playground

Run this model interactively with your own prompts.

​
Quick Start

import fal_client

def on_queue_update(update):
    if isinstance(update, fal_client.InProgress):
        for log in update.logs:
           print(log["message"])

result = fal_client.subscribe(
    "fal-ai/hunyuan-3d/v3.1/rapid/image-to-3d",
    arguments={
        "input_image_url": "https://v3b.fal.media/files/b/0a865ab1/omYcawLUo4RZbO8J6ZgZR.png"
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

​
Input Schema

​
input_image_url
string
required
Front view image URL. Resolution: 128-5000px, max 8MB (recommended ≤6MB for base64 encoding), formats: JPG/PNG/WEBP. Tips: simple background, single object, object >50% of frame.
​
enable_pbr
boolean
default:"false"
Enable PBR material generation (metallic, roughness, normal textures). Does not take effect when enable_geometry is True.
​
enable_geometry
boolean
default:"false"
Generate geometry-only white model without textures. When enabled, enable_pbr is ignored and OBJ is not supported (default output is GLB).

​
Output Schema

​
model_glb
File
Generated 3D model file. Contains GLB if available, otherwise OBJ.
​
material_mtl
File
MTL material file for the OBJ model.
​
texture
File
Texture image for the 3D model.
​
thumbnail
File
Preview thumbnail of the generated model
​
model_urls
ModelUrls
required
URLs for different 3D model formats.

​
Input Example

{
  "input_image_url": "https://v3b.fal.media/files/b/0a865ab1/omYcawLUo4RZbO8J6ZgZR.png",
  "enable_pbr": false,
  "enable_geometry": false
}

​
Output Example

{
  "model_glb": {
    "content_type": "model/obj",
    "file_name": "8b1dbea208d194b9089a950abc2df426.obj",
    "file_size": 3172659,
    "url": "https://v3b.fal.media/files/b/0a8c4439/vj933H8B4W3wbd3e2RNby_8b1dbea208d194b9089a950abc2df426.obj"
  },
  "material_mtl": {
    "content_type": "text/plain",
    "file_name": "material.mtl",
    "file_size": 88,
    "url": "https://v3b.fal.media/files/b/0a8c4439/_RhytNH4xZ5EFHr34YzJt_material.mtl"
  },
  "texture": {
    "content_type": "image/png",
    "file_name": "texture_20250901.png",
    "file_size": 11728567,
    "url": "https://v3b.fal.media/files/b/0a8c4439/_4NXiSoGcZ-GYwmgUTfHZ_texture_20250901.png"
  },
  "thumbnail": {
    "content_type": "image/png",
    "file_name": "preview.png",
    "file_size": 82521,
    "url": "https://v3b.fal.media/files/b/0a8c4439/70Sm1pZ16SQP-mEbaKICC_preview.png"
  },
  "model_urls": {
    "mtl": {
      "content_type": "text/plain",
      "file_name": "material.mtl",
      "file_size": 88,
      "url": "https://v3b.fal.media/files/b/0a8c4439/_RhytNH4xZ5EFHr34YzJt_material.mtl"
    },
    "obj": {
      "content_type": "model/obj",
      "file_name": "8b1dbea208d194b9089a950abc2df426.obj",
      "file_size": 3172659,
      "url": "https://v3b.fal.media/files/b/0a8c4439/vj933H8B4W3wbd3e2RNby_8b1dbea208d194b9089a950abc2df426.obj"
    },
    "texture": {
      "content_type": "image/png",
      "file_name": "texture_20250901.png",
      "file_size": 11728567,
      "url": "https://v3b.fal.media/files/b/0a8c4439/_4NXiSoGcZ-GYwmgUTfHZ_texture_20250901.png"
    }
  }
}