Skip to main content
Hunyuan3D is Tencent’s AI 3D generation model. Blender MCP supports two modes: Official API through Tencent Cloud and Local API for self-hosted instances. Like Hyper3D Rodin, it excels at generating single objects from a text description or reference image, giving you an alternative when you already have a Tencent Cloud account or prefer a self-hosted pipeline.

​
Setup

The setup depends on which mode you use.
1
Get your SecretId and SecretKey from cloud.tencent.com.
2
In Blender, go to Edit → Preferences → Add-ons → Blender MCP.
3
Enter your credentials in the Hunyuan3D fields.
Alternatively, set the environment variables before starting Blender:

​
Official API Workflow

When using the Official API, generation follows an asynchronous three-step process:
1
Create task — Call generate_hunyuan3d_model(text_prompt) or pass an image URL to start generation. This returns a job ID.
2
Poll — Call poll_hunyuan_job_status(job_id) repeatedly until the status returns DONE.
3
Import — Call import_generated_asset_hunyuan(name, zip_file_url) to download and place the model. Prefer the .glb URL from ResultFile3Ds if available.

​
Local API Workflow

When using the Local API, the process is simpler. Call generate_hunyuan3d_model(text_prompt) or pass an image, and the tool handles the full flow in a single call. No manual polling is required.
Blender must be running with a GUI, not headless. After import, check the world bounding box and adjust location, scale, and rotation as needed.

​
Best For

Use Hunyuan3D when you need single custom objects not available in asset libraries. It is a strong alternative to Hyper3D Rodin if you already have a Tencent Cloud account or want a fully self-hosted generation pipeline.

Tencent Cloud Users

Ideal if you already have Tencent Cloud credentials and want to reuse them for 3D generation.

Self-Hosted Workflows

Run generation locally without relying on external cloud services or rate limits.