Tencent Hunyuan 3D

API Notes

tencent_hunyuan_3d requires exactly one primary input among prompt, image_url, and image_base64

tencent_hunyuan_3d supports multi-view guidance through multi_view_images with View and either ImageUrl or ImageBase64

tencent_hunyuan_3d only accepts left, right, and back as View values in multi_view_images

Authentication

authorization string required

All APIs require authentication via Bearer Token.

Get API Key:

Visit API Key Management Page to get your API Key.

Usage:

Add to request header:

Authorization: Bearer YOUR_API_KEY

Parameters

model string required

Model ID to use for the request

Value: tencent_hunyuan_3d

---

prompt string

Text prompt for text-to-3D generation. Provide exactly one of prompt, image_url, or image_base64

Maximum length: 1024 UTF-8 characters

---

image_base64 string

Base64-encoded input image. Provide exactly one of prompt, image_url, or image_base64

Supported formats: jpg, png, jpeg, webp
Image size: up to 8MB
Resolution: each side must be between 128 and 5000 pixels

---

image_url string

Publicly accessible input image URL. Provide exactly one of prompt, image_url, or image_base64

Supported formats: jpg, png, jpeg, webp
Image size: up to 8MB
Resolution: each side must be between 128 and 5000 pixels

---

result_format string

Desired export format for the generated 3D asset or preview output

Options: OBJ, GLB, STL, USDZ, FBX, MP4

---

enable_pbr boolean

Whether to enable PBR material generation for the output asset

Options: true, false

---

multi_view_images array

Optional multi-view reference images used to improve geometry consistency. Each item must include View and either ImageUrl or ImageBase64

Supported views: left, right, back

item object

A single multi-view image object

View string required

View identifier for the reference image

Options: left, right, back

ImageUrl string

Publicly accessible image URL for the specified view

ImageBase64 string

Base64-encoded image content for the specified view

---

Polling

Since result generation takes time, you need to poll the task status after creating the task.

The initial response only returns information such as the task ID and initial status. The final result must be obtained by polling the task status endpoint using the task ID.

See the examples on the right for polling requests and responses.

---

Response Format

error object

Error information, only present when status is failed

code string

Error code

message string

Detailed error message

---

output array

Generation results, only present when status is completed

content array

List of generated resource content

type string

Resource type

Value: image｜video

url string

Processed resource URL

jobId string

Remote task ID

---

usage object

Usage statistics, only present when status is completed

cost string

Total cost in USD

discount number

Discount amount

---

metadata object

Metadata information

---

Error Codes

Error Code	Description
13002095	Upstream internal generation error
13002096	Result parsing exception
13002097	Upstream HTTP response error
13002098	Task status polling exception
13002099	Upstream task creation exception