# Tencent Cloud Hunyuan 3D Generation API

> Tencent Cloud Hunyuan 3D Generation API on Apizie: 17 endpoints (Convert3 DFormat, Describe Auto Rigging Job, Describe Hunyuan To3 DMotion Job, Describe Hunyuan To3 DUVJob, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:tencent-ai3d/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:tencent-ai3d`
- Category: Cloud
- Status: byok
- Source: https://www.tencentcloud.com/document/api
- Page: https://zieapi.vercel.app/api/cloud/tencent-ai3d
- OpenAPI: https://zieapi.vercel.app/api/cloud/tencent-ai3d/openapi.json

Tencent Cloud API 3.0 for Hunyuan 3D Generation (ai3d). Every call is signed with TC3-HMAC-SHA256 using your SecretId and SecretKey.

## Endpoints

### Convert3 DFormat
`POST https://zieapi.vercel.app/v1/cloud:tencent-ai3d/convert3-dformat` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| File3D | string | yes |  |
| Format | string | yes |  |

### Describe Auto Rigging Job
`POST https://zieapi.vercel.app/v1/cloud:tencent-ai3d/describe-auto-rigging-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| JobId | string | yes |  |

### Describe Hunyuan To3 DMotion Job
`POST https://zieapi.vercel.app/v1/cloud:tencent-ai3d/describe-hunyuan-to3-dmotion-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| JobId | string | yes |  |

### Describe Hunyuan To3 DUVJob
`POST https://zieapi.vercel.app/v1/cloud:tencent-ai3d/describe-hunyuan-to3-duvjob` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| JobId | string | yes |  |

### Describe Reduce Face Job
`POST https://zieapi.vercel.app/v1/cloud:tencent-ai3d/describe-reduce-face-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| JobId | string | no |  |

### Describe Texture To3 DJob
`POST https://zieapi.vercel.app/v1/cloud:tencent-ai3d/describe-texture-to3-djob` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| JobId | string | no |  |

### Query Hunyuan3 DPart Job
`POST https://zieapi.vercel.app/v1/cloud:tencent-ai3d/query-hunyuan3-dpart-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| JobId | string | yes |  |

### Query Hunyuan To3 DPro Job
`POST https://zieapi.vercel.app/v1/cloud:tencent-ai3d/query-hunyuan-to3-dpro-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| JobId | string | yes |  |

### Query Hunyuan To3 DRapid Job
`POST https://zieapi.vercel.app/v1/cloud:tencent-ai3d/query-hunyuan-to3-drapid-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| JobId | string | no |  |

### Submit Auto Rigging Job
`POST https://zieapi.vercel.app/v1/cloud:tencent-ai3d/submit-auto-rigging-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| File3D | object | yes |  |
| MotionType | integer | no |  |

### Submit Hunyuan3 DPart Job
`POST https://zieapi.vercel.app/v1/cloud:tencent-ai3d/submit-hunyuan3-dpart-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| File | object | no |  |
| Model | string | no |  |
| PartSegmentationInfo | string | no |  |
| EnableStagedGeneration | boolean | no |  |
| EnablePostProcess | boolean | no |  |

### Submit Hunyuan To3 DMotion Job
`POST https://zieapi.vercel.app/v1/cloud:tencent-ai3d/submit-hunyuan-to3-dmotion-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Prompt | string | yes |  |
| Model | string | no |  |
| RetargetFile | object | no |  |
| Duration | integer | no |  |
| EnableMesh | boolean | no |  |
| EnableRewrite | boolean | no |  |
| EnableDurationEst | boolean | no |  |

### Submit Hunyuan To3 DPro Job
`POST https://zieapi.vercel.app/v1/cloud:tencent-ai3d/submit-hunyuan-to3-dpro-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Model | string | no |  |
| Prompt | string | no |  |
| ImageBase64 | string | no |  |
| ImageUrl | string | no |  |
| MultiViewImages | array | no |  |
| EnablePBR | boolean | no |  |
| FaceCount | integer | no |  |
| GenerateType | string | no |  |
| PolygonType | string | no |  |
| ResultFormat | string | no |  |

### Submit Hunyuan To3 DRapid Job
`POST https://zieapi.vercel.app/v1/cloud:tencent-ai3d/submit-hunyuan-to3-drapid-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Prompt | string | no |  |
| ImageBase64 | string | no |  |
| ImageUrl | string | no |  |
| ResultFormat | string | no |  |
| EnablePBR | boolean | no |  |
| EnableGeometry | boolean | no |  |

### Submit Hunyuan To3 DUVJob
`POST https://zieapi.vercel.app/v1/cloud:tencent-ai3d/submit-hunyuan-to3-duvjob` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| File | object | no |  |

### Submit Reduce Face Job
`POST https://zieapi.vercel.app/v1/cloud:tencent-ai3d/submit-reduce-face-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| File3D | object | yes |  |
| PolygonType | string | no |  |
| FaceLevel | string | no |  |

### Submit Texture To3 DJob
`POST https://zieapi.vercel.app/v1/cloud:tencent-ai3d/submit-texture-to3-djob` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| File3D | object | yes |  |
| Model | string | no |  |
| MultiViewImages | array | no |  |
| Prompt | string | no |  |
| Image | object | no |  |
| EnablePBR | boolean | no |  |
| EnableKeepUV | boolean | no |  |
| TextureSize | integer | no |  |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:tencent-ai3d/convert3-dformat" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Tencent Cloud Hunyuan 3D Generation API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:tencent-ai3d/convert3-dformat with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Tencent Cloud Hunyuan 3D Generation API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Tencent Cloud Hunyuan 3D Generation itself also needs your own key from tencentcloudapi.com.

### Can AI agents use the Tencent Cloud Hunyuan 3D Generation API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:tencent-ai3d.

### What is the status of the Tencent Cloud Hunyuan 3D Generation API?
Needs your own provider key (bring your own key)