Tencent Hunyuan 3D Rapid

API Notes

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

tencent_hunyuan_3d_rapid exposes enable_pbr, result_format, and enable_geometry as optional generation controls

tencent_hunyuan_3d_rapid does not expose face_count, generate_type, polygon_type, or an upstream model selector inside params; multi_view_images is accepted for compatibility but is not forwarded upstream

tencent_hunyuan_3d_rapid uses format instead of type to identify the actual asset format in output[].content[], and url typically returns a .zip package when format is obj

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_rapid

---

prompt string

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

Maximum length: 200 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
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
Resolution: each side must be between 128 and 5000 pixels

---

result_format string

Desired export format for the generated 3D asset. Use output[].content[].format as the authoritative returned format. When format is obj, the downloadable url usually points to a .zip package

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

---

enable_pbr boolean

Whether to enable PBR material generation for the output asset

Options: true, false

---

enable_geometry boolean

Whether to request geometry-only output when supported by the upstream Rapid interface

Options: true, false

---

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

id string required

Task ID

---

created_at integer required

Task creation timestamp in milliseconds

---

status string required

Task status

Options: in_progress, completed, failed

---

model string required

Model ID

---

progress number

Task progress, only present when status is in_progress

---

error object

Error information, only present when status is failed

code string

Error code

message string

Detailed error message

---

output array

Generated results, only present when status is completed

content array

Downloadable model resources for the completed task

type string

Wrapper resource type. In current 3D responses this field may still return glb even when format is obj, so use format to determine the actual asset format

format string

Actual export format for the returned asset, such as obj or glb

url string

Download URL for the model asset. When format is obj, this URL usually points to a .zip package

preview_url string

Preview image URL for the current asset

jobId string

Upstream job ID. Multiple assets in the same task can share the same jobId

---

usage object

Billing and usage information, only present when status is completed

cost string

Total cost in USD. This field can be an empty string when billing data is not returned

input_tokens number

Input token count. Current 3D tasks usually return null

output_tokens number

Output token count. Current 3D tasks usually return null

quantity integer

Billable quantity for the task

total_tokens number

Total token count. Current 3D tasks usually return null

unit_price string

Unit price in USD. This field can be an empty string when billing data is not returned

user_discount number

User discount value returned by the wrapper

---

metadata object

Timing metadata returned by the wrapper

completed_at number

Time to completion in seconds

in_queue_at number

Time spent in queue in seconds

upload_at number

Upload and preprocessing time in seconds

---

Error Codes

Error Code	Description
13003095	Upstream internal generation error
13003096	Result parsing exception
13003097	Upstream HTTP response error
13003098	Task status polling exception
13003099	Upstream task creation exception