Hunyuan Part API

hunyuan-part
The model improves 3D asset usability by delivering production-ready parts with preserved topology and high structural accuracy.
Output
$0.052 / gen
Released
Nov 17, 2025

Overview

‍

Hunyuan Part API Overview

Hunyuan Part is a specialized 3D AI model from the Tencent Hunyuan ecosystem designed to understand, analyze, and deconstruct complex 3D meshes into meaningful structural components. Instead of generating full objects, it focuses on what happens inside the geometry, identifying parts, boundaries, and functional regions that define how a model is built.

In modern 3D pipelines, raw meshes are often difficult to edit, rig, or reuse. Hunyuan Part solves this by transforming a single unified object into a structured collection of editable components, making it significantly easier to adapt assets for animation, game development, simulation, or digital manufacturing workflows.

Technical Overview

Parameter Description
Supported Input Formats OBJ, GLB meshes
Output Structure Independent 3D mesh components
Core Processing Method Point-based sampling with semantic segmentation
Typical Mesh Density Handling High-density geometry supported
Primary Function Structural decomposition of 3D objects

API Pricing

  • $0.052 per generation

How Hunyuan Part Reframes 3D Understanding

Traditional segmentation tools rely heavily on geometric similarity, which often leads to inconsistent or visually inaccurate splits. Hunyuan Part takes a different approach by combining geometric reasoning with learned semantic structure, allowing it to understand what a part represents, not just how it looks.

In practice, this means the model can distinguish between components like handles, limbs, wheels, or mechanical joints even when their shapes are visually similar or partially obscured. This shift from surface-level clustering to semantic decomposition is what makes the system particularly effective in production environments.

The model processes standard 3D formats such as OBJ and GLB, converting them into structured representations that can be directly reused in downstream tools without manual cleanup. According to official documentation, it is optimized for dense mesh inputs and point-based sampling strategies that improve segmentation precision across complex geometry.

Core Functional Capabilities

Focus on Production-Ready 3D Workflows

Hunyuan Part is designed specifically for real production environments where usability, accuracy, and structural consistency are more important than purely visual results. Its purpose is to support downstream pipelines such as animation, game development, and simulation by turning complex meshes into clean, structured components.

Structural Decomposition of 3D Objects

One of the core capabilities of the model is structural decomposition. It begins by analyzing the global shape of a 3D object and then progressively identifies boundaries between meaningful regions within the mesh.

Instead of treating the model as a single continuous surface, it systematically separates it into logically distinct parts. This process ensures that each component reflects a meaningful structural element rather than an arbitrary geometric split.

Semantic Awareness of Functional Components

Beyond geometry, Hunyuan Part incorporates semantic understanding of 3D structure. It does not treat objects as uniform surfaces but instead interprets functional relationships between different regions.

This allows it to consistently identify meaningful components such as limbs, mechanical joints, or structural attachments, even in complex or articulated models. As a result, segmentation remains stable and logically coherent across a wide range of 3D assets.

Functional Comparison in 3D Segmentation

Aspect Conventional Segmentation Tools Hunyuan Part
Understanding of Structure Mostly geometric Semantic + geometric
Output Usability Requires cleanup Production-ready parts
Consistency Across Complex Meshes Medium High stability
Automation Level Semi-manual workflows Fully automated pipeline

Use Cases

Game Development

Hunyuan Part is particularly useful in game development environments where 3D assets need to be modified, reused, or optimized at scale. It reduces the time required to prepare models for rigging and animation by automatically separating functional components of characters and objects, removing much of the manual preprocessing typically required in asset production workflows.

Animation and VFX Production

In animation and VFX pipelines, the model provides a more structured way to manage deformation zones. By isolating meaningful parts of a mesh, it becomes easier to apply motion without breaking structural integrity or introducing unwanted distortions.

This is especially important for articulated characters, complex creatures, or mechanical scenes where precise control over movement and deformation is required.

3D Data for Robotics and Simulation Systems

Hunyuan Part is also highly relevant in robotics and simulation contexts, where structured and interpretable 3D data is essential. It converts raw geometry into meaningful, segmented components that can be used for training perception models or simulating real-world interactions.

By bridging the gap between visual representation and machine-readable structure, it helps enable more accurate and scalable AI-driven simulation pipelines.

‍

Use cases

  • Professional Photo Retouching: Correction or enhancement of portraits, backgrounds, lighting, object removal/addition, while preserving original style.
  • Advanced Photomontage: Combining multiple images/components into a single scene with consistent lighting and style.
  • Visual Effects & Advertising: Scene adjustments, object insertion/removal, background replacement with natural blending.
  • Product & E-commerce Imaging: Enhancing product photos, changing backgrounds, adjusting lighting, fine-tuning reflectance or material consistency.

‍

How to use Hunyuan Part API

Install any OpenAI-compatible SDK, point it at api.aimlapi.com/v1, and set the model to hunyuan-part.
import requests

r = requests.post(
    "https://api.aimlapi.com/v1/images/generations",
    headers={"Authorization": "Bearer " + AIMLAPI_KEY},
    json={
      "model": "hunyuan-part",
      "prompt": "A cat holding a sign that says hello"
    },
)
print(r.json())
const r = await fetch("https://api.aimlapi.com/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.AIMLAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "hunyuan-part",
    "prompt": "A cat holding a sign that says hello"
  }),
});
console.log(await r.json());
curl -X POST https://api.aimlapi.com/v1/images/generations \
  -H "Authorization: Bearer $AIMLAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"hunyuan-part","prompt":"A cat holding a sign that says hello"}'

OpenAI-compatible — swap the base URL and it works with your existing SDK.

Hunyuan Part API Pricing

TypePrice
Output
$0.052 / gen

Hunyuan Part vs other models

ModelInputOutputContextBest for
Hunyuan Part
This page
$0.052 / gen
Image generation at scale
$0.325 / 1M tokens
$78 / 1M tokens
128K tokens
Image generation at scale
$6.5 / 1M tokens
$39 / 1M tokens
Image generation at scale
$0.325 / gen
Image generation at scale
$0.0195 / MP (variable)
Image generation at scale

Frequently asked questions

Hunyuan Part takes image, text as input and returns image.

Hunyuan Part is priced at $0.052 / gen.

Hunyuan Part is billed per generation — a fixed charge per output rather than by prompt length.

Yes, Hunyuan Part accepts image input as well as a text prompt.

Hunyuan Part was built by Tencent.

Send a request to https://api.aimlapi.com/v1/images/generations with hunyuan-part as the model id.

Yes. Hunyuan Part is served through AI/ML API, so the same key and endpoint format used for other models applies.

Start building with Hunyuan Part

Get API Key
1000+ models, one API.