Tencent Hunyuan 3D Rapid Intl

API Notes

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

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

tencent_hunyuan_3d_rapid_intl does not expose face_count, generate_type, polygon_type, multi_view_images, or an upstream model selector inside params

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_intl

---

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 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

---

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

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
13003095	Upstream internal generation error
13003096	Result parsing exception
13003097	Upstream HTTP response error
13003098	Task status polling exception
13003099	Upstream task creation exception