Hunyuan 3D Smart Topology

Name: Tencent Hunyuan 3D Smart Topology
Price: 0.75 USD
Availability: InStock
Author: Tencent

tencent/hunyuan-3d/3.1/smart-topology

Hunyuan 3d 3.1 Smart Topology by Tencent - advanced AI model for 3d-to-3d. Delivers high-quality results with fast inference, suitable for both creative and production workflows.

Use in agent Get API key

Base price: $0.75USD / run
Execution: async
Model type: image
Input fields: 4

Try the model

Playground

Open playground

Input

Input File Type(string)

Input 3D file format. Allowed values: glb, obj.

Input File Url(string)

URL of GLB or OBJ file to optimize topology. Max size: 200MB.

Polygon Type(string)

Output polygon type. triangle: triangular faces only. quadrilateral: mixed quad and triangle faces. Allowed values: triangle, quadrilateral.

Face Level(string)

Target polygon density. high: more detail/polygons, medium: balanced, low: fewer polygons. Allowed values: high, medium, low.

OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price: $0.75 / run

Context & modalities

Input: Schema-defined
Output: image

Capabilities

Chat: Not supported
Vision: Not supported
Reasoning: Not supported
Structured output: Not supported
Function calling: Not supported
Audio input: Not supported

Access

Provider: Tencent
Model ID: tencent/hunyuan-3d/3.1/smart-topology
Execution: async
Base URL: https://api.sandbase.ai
API: Unified Run API
Endpoint: /v1/run

API README

Hunyuan 3D Smart Topology

Hunyuan 3D Smart Topology occupies a clearly bounded position in a image production pipeline under the route tencent/hunyuan-3d/3.1/smart-topology. It is best evaluated as a named workflow endpoint rather than as a generic substitute for neighboring versions: planners can assign the route to a specific brief, record the chosen revision, and keep approval history tied to one predictable integration surface from intake through delivery.

A practical rollout of Hunyuan 3D Smart Topology should begin with source-readiness checks, ownership of the submitted material, an agreed budget, and a written definition of the final smart topology deliverable. Before automation is enabled, the acceptance pass should verify that the returned asset opens correctly, fits the intended downstream toolchain, satisfies the project’s review criteria, and can be reproduced from the stored request and route identity tencent/hunyuan-3d/3.1/smart-topology.

Highlights

Distinct output behavior. For Hunyuan 3D Smart Topology, for Hunyuan 3D Smart Topology, process an existing model through the documented 3D-to-3D operation In Hunyuan 3D Smart Topology, this capability is applied through the exact tencent/hunyuan-3d/3.1/smart-topology workflow with face level as a relevant request control; the face level control exposes the corresponding choice in this route; the face level control exposes the corresponding choice in this route.
Creative control. For Hunyuan 3D Smart Topology, for Hunyuan 3D Smart Topology, select the incoming format explicitly In Hunyuan 3D Smart Topology, this capability is applied through the exact tencent/hunyuan-3d/3.1/smart-topology workflow with polygon type as a relevant request control; the polygon type control exposes the corresponding choice in this route; the polygon type control exposes the corresponding choice in this route.
Workflow fit. For Hunyuan 3D Smart Topology, for Hunyuan 3D Smart Topology, choose high, medium, or low target polygon density In Hunyuan 3D Smart Topology, this capability is applied through the exact tencent/hunyuan-3d/3.1/smart-topology workflow with input file url as a relevant request control; the input file url control exposes the corresponding choice in this route; the input file url control exposes the corresponding choice in this route.
Production detail. For Hunyuan 3D Smart Topology, for Hunyuan 3D Smart Topology, request triangles or a mixed quad-and-triangle mesh In Hunyuan 3D Smart Topology, this capability is applied through the exact tencent/hunyuan-3d/3.1/smart-topology workflow with input file type as a relevant request control; the input file type control exposes the corresponding choice in this route; the input file type control exposes the corresponding choice in this route.

Pricing

Configuration	Price
Per request	$0.75

When to Use

Scenario	Why this model fits
Choose Hunyuan 3D Smart Topology	Use it when the required deliverable is specifically the 3D smart topology result documented for `tencent/hunyuan-3d/3.1/smart-topology`.
Match the source material	Select this route when your inputs naturally map to `face_level`, `polygon_type`, `input_file_url`, `input_file_type`.
Use its distinguishing capability	For Hunyuan 3D Smart Topology, process an existing model through the documented 3D-to-3D operation In Hunyuan 3D Smart Topology, this capability is applied through the exact tencent/hunyuan-3d/3.1/smart-topology workflow with face level as a relevant request control; the face level control exposes the corresponding choice in this route
Plan repeatable production	For Hunyuan 3D Smart Topology, select the incoming format explicitly In Hunyuan 3D Smart Topology, this capability is applied through the exact tencent/hunyuan-3d/3.1/smart-topology workflow with polygon type as a relevant request control; the polygon type control exposes the corresponding choice in this route
Confirm cost and delivery	Use the pricing combinations below and the output contract above when budgeting or automating Hunyuan 3D Smart Topology jobs.

Prompt Guide

Build the request around the exact tencent/hunyuan-3d/3.1/smart-topology schema. Start with required fields, then add only the controls needed for the intended output; keep URLs reachable and enum values exactly as shown in Technical Specs.

{
  "face_level": "medium",
  "polygon_type": "triangle",
  "input_file_url": "https://static.sandbase.ai/examples/tencent/hunyuan-3d/3.1/smart-topology/input_input_file_url_0.glb",
  "input_file_type": "glb"
}

Technical Specs

Specification	Value
Model ID	`tencent/hunyuan-3d/3.1/smart-topology`
Execution mode	`async`
Required inputs	None marked required
Request fields	`face_level` (string, optional, options: high / medium / low); `polygon_type` (string, optional, options: triangle / quadrilateral); `input_file_url` (string, optional); `input_file_type` (string, optional, options: glb / obj)
Output	`url` (string); `content_type` (string)

Related Models

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API

Unified Run API endpoint

https://api.sandbase.ai/v1/run

Model ID

tencent/hunyuan-3d/3.1/smart-topology

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "tencent/hunyuan-3d/3.1/smart-topology",
  "face_level": "medium",
  "polygon_type": "triangle",
  "input_file_url": "https://static.sandbase.ai/examples/tencent/hunyuan-3d/3.1/smart-topology/input_input_file_url_0.glb",
  "input_file_type": "glb"
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

Choose your model

Compare models

All image & video models

Model	Type	Default price	Released
Hunyuan 3D Smart TopologyThis model `Tencent`	Image	$0.75 / run	Jan 27, 2026
Hunyuan Image 3.0 Edit `Tencent`	Image	$0.45 / run	Jan 28, 2026
Hunyuan 3D 3.1 Pro Text to 3D `Tencent`	Image	$0.38 / run	Jan 27, 2026
Hunyuan 3D 3.1 Pro Image to 3D `Tencent`	Image	$0.38 / run	Jan 27, 2026
Hunyuan 3D 3.0 Image to 3D `Tencent`	Image	$0.63 / run	Dec 16, 2025
Hunyuan Image 3.0 Text to Image `Tencent`	Image	$0.10 / run	Sep 28, 2025

Questions

FAQ

How do I call Tencent Hunyuan 3D Smart Topology through SandBase?

Create a SandBase API key, then send requests with the model ID "tencent/hunyuan-3d/3.1/smart-topology" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

Do I need a separate Tencent account?

No. One SandBase API key and balance gives you access to Tencent Hunyuan 3D Smart Topology and the other models in the catalog; you do not need to sign up with Tencent separately.