Sign in

v12

OpenAPI 3.1.02026-08-031000506.8 KB
3D

Hunyuan3D 3.1 Pro

High‑fidelity text or image‑to‑3D with optional PBR materials, multi‑view inputs, and adjustable face count for cleaner meshes.

post/generate/3d/tencent/hunyuan3d-3.1-pro

Headers

X-Webhook-URLstring uri

URL to receive a POST request when the job completes. The webhook will receive the job data including results.

Request body

promptstring
seednumber
input_mode'image' | 'text'
generate_textureboolean
enable_pbrboolean
face_countnumber
back_image_urlstring uri

Optional back-view image URL.

left_image_urlstring uri

Optional left-view image URL.

right_image_urlstring uri

Optional right-view image URL.

top_image_urlstring uri

Optional top-view image URL.

bottom_image_urlstring uri

Optional bottom-view image URL.

left_front_image_urlstring uri

Optional left-front-view image URL.

right_front_image_urlstring uri

Optional right-front-view image URL.

image_urlsstring[]

Input image URLs for image-to-3D generation. Omit or pass an empty array for text-to-3D.

Response

The resulting job data. This will be returned in a pending state until the job is completed. See /jobs/{id} for retrieving the results.

job_idstring uuid required
status'backlogged' | 'queued' | 'scheduled' | 'processing' | 'sampling' | 'intermediate-complete' | 'completed' | 'failed' | 'cancelled' required
created_atstring date-time required
{"stackTrail":"paths:/generate/3d/tencent/hunyuan3d-3.1-pro:post:responses:200:content:application/json:schema:properties:completed_at","oasType":"schema","type":"unknown"}
{"stackTrail":"paths:/generate/3d/tencent/hunyuan3d-3.1-pro:post:responses:200:content:application/json:schema:properties:result","oasType":"schema","type":"unknown"}