Hunyuan 3d V3.1 Smart Topology API

API reference for Hunyuan 3d V3.1 Smart Topology. Optimize 3D mesh topology with Hunyuan 3D Smart Topology.

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

Python

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)

import { fal } from "@fal-ai/client";

const result = await fal.subscribe("fal-ai/hunyuan-3d/v3.1/smart-topology", {
  input: {},
  logs: true,
  onQueueUpdate: (update) => {
    if (update.status === "IN_PROGRESS") {
      update.logs.map((log) => log.message).forEach(console.log);
    }
  },
});
console.log(result.data);
console.log(result.requestId);

curl --request POST \
  --url https://fal.run/fal-ai/hunyuan-3d/v3.1/smart-topology \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{}'

Related

• Hunyuan 3D Pro Image to 3D — 3D
• Hunyuan 3D Pro Text to 3D — 3D
• Hunyuan 3D Rapid Image to 3D — 3D
• Hunyuan 3d — 3D
• Hunyuan 3D Part Splitter — 3D

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