MCP for Blender
Menu Hunyuan3D

Integrations

Hunyuan3D Integration: Tencent AI 3D Generation in MCP for Blender

Generate 3D models from text or images using Hunyuan3D by Tencent inside MCP for Blender, supporting both Official API and Local API modes.

Hunyuan3D is Tencent's AI 3D generation model. MCP for Blender 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 (mainland) or tencentcloud.com (international).

  2. In Blender, press N in the 3D viewport, open the MCP for Blender tab, tick Tencent Hunyuan 3D, and set Mode to official api.

  3. Enter your SecretId and SecretKey. To store them permanently, use Edit → Preferences → Add-ons → MCP for Blender instead.

  4. If your credentials come from tencentcloud.com, tick International (Pro) account. International credentials sent to the mainland endpoint fail with AuthFailure.SignatureFailure or ResourceUnavailable.

Alternatively, set the environment variables before starting Blender:

export BLENDERMCP_HUNYUAN3D_SECRET_ID="your-secret-id"
export BLENDERMCP_HUNYUAN3D_SECRET_KEY="your-secret-key"

  1. Set up your self-hosted Hunyuan3D instance.

  2. In Blender, open the MCP for Blender tab, tick Tencent Hunyuan 3D, and set Mode to local api (the default).

  3. Enter your local API URL in the API URL field (default http://localhost:8081). To store it permanently, use the Hunyuan3D API URL field in Edit → Preferences → Add-ons → MCP for Blender.

Alternatively, set the environment variable:

export BLENDERMCP_HUNYUAN3D_API_URL="http://localhost:8081"

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.