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

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/smart-topology",
    arguments={},
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

​
API Reference

​
Input Schema

​
input_file_url
string
URL of GLB or OBJ file to optimize topology. Max size: 200MB. Default value: "https://v3b.fal.media/files/b/0a8c09c0/VYDiCTcDGK55qY2-idGbX_model.glb"
​
input_file_type
InputFileTypeEnum
default:"glb"
Input 3D file format. Default value: "glb"Possible values: glb, obj
​
polygon_type
PolygonTypeEnum
default:"triangle"
Output polygon type. triangle: triangular faces only. quadrilateral: mixed quad and triangle faces. Default value: "triangle"Possible values: triangle, quadrilateral
​
face_level
FaceLevelEnum
default:"medium"
Target polygon density. high: more detail/polygons, medium: balanced, low: fewer polygons. Default value: "medium"Possible values: high, medium, low

​
Output Schema

​
model_glb
File
required
Processed 3D model with optimized topology (primary file).
​
model_urls
ModelUrls
required
URLs for different 3D model formats

​
Input Example

{
  "input_file_url": "https://v3b.fal.media/files/b/0a8c09c0/VYDiCTcDGK55qY2-idGbX_model.glb",
  "input_file_type": "glb",
  "polygon_type": "triangle",
  "face_level": "medium"
}

​
Output Example

{
  "model_glb": {
    "content_type": "model/obj",
    "file_name": "model.obj",
    "file_size": 394409,
    "url": "https://v3b.fal.media/files/b/0a8c0ab4/tqMY5NJLnHjpwN8rQ15dj_model.obj"
  },
  "model_urls": {
    "glb": {
      "content_type": "model/gltf-binary",
      "file_name": "model.glb",
      "file_size": 206004,
      "url": "https://v3b.fal.media/files/b/0a8c0ab4/eX-_x0Wv8fZL05l9CGp6Y_model.glb"
    },
    "obj": {
      "content_type": "model/obj",
      "file_name": "model.obj",
      "file_size": 394409,
      "url": "https://v3b.fal.media/files/b/0a8c0ab4/tqMY5NJLnHjpwN8rQ15dj_model.obj"
    }
  }
}

​
Limitations

  • input_file_type restricted to: glb, obj
  • polygon_type restricted to: triangle, quadrilateral
  • face_level restricted to: high, medium, low