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"

Generation Workflow

Your AI generates models with generate_3d, which submits the job, waits for it, and imports the result in one call. If generation takes longer than the wait time, it returns a job handle and the AI calls it again to keep waiting.

generate_3d(prompt="ceramic teapot", provider="hunyuan3d")

This works the same way in Official API and Local API modes.

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.