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.
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runtencent/hunyuan-3d/3.1/smart-topologyInput Schema
4 parameters · 0 required · 4 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
face_level | string | Optional | Target polygon density. high: more detail/polygons, medium: balanced, low: fewer polygons. · Options: high, medium, low · Default: "medium" highmediumlow |
polygon_type | string | Optional | Output polygon type. triangle: triangular faces only. quadrilateral: mixed quad and triangle faces. · Options: triangle, quadrilateral · Default: "triangle" trianglequadrilateral |
input_file_url | string | Optional | URL of GLB or OBJ file to optimize topology. Max size: 200MB. · Default: "https://static.sandbase.ai/examples/tencent/hunyuan-3d/3.1/smart-topology/input_input_file_url_0.glb" |
input_file_type | string | Optional | Input 3D file format. · Options: glb, obj · Default: "glb" glbobj |
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
Async Workflow
This model uses asynchronous execution. Submit a request and poll for the result.
- Submit — POST to /v1/run, receive an
id - Poll — GET /v1/run/{id} until status is
completed,failed, ortimeout - Retrieve — Read
outputsfrom the completed response
Code Examples
Ready-to-run snippets
# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"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",
"prompt": "a beautiful sunset over mountains"
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"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) |

