Tencent Hunyuan Image · 3D · Image

3D Model GenerationNEW

📌 What is this：Generate a 3D model (GLB / OBJ / FBX files + preview images) from a text prompt or a single reference image.

💡 When to use：Use for game / e-commerce / 3D-printing assets. Send exactly one of prompt or imageUrls (1 image).

Endpoints

Usage	Method	Path
Submit task	POST	/api/cqt/generator/hunyuan
Query Result	GET	/api/cqt/info/hunyuan?id={taskId}

⏱ Recommended polling interval：Poll every 5-10s until status = succeeded / failed.

Sub-models

model	Usage	Materials	Output files	Price (credits/call)
hunyuan-3d-3.1	Full 3D asset (geometry + texture)	prompt or 1 reference image	GLB, OBJ, OBJ zip + PNG	200
hunyuan-3d-3.1-geometry	Geometry only (no texture)	prompt or 1 reference image	GLB, FBX + PNG	100

Request Parameters

Param	Type	Required	Description
model	string	Required	hunyuan-3d-3.1 / hunyuan-3d-3.1-geometry
prompt	string	—	Text description (or imageUrls)
imageUrls	array	—	A single reference image (array with 1 item; or prompt)
seed	integer	—	Random seed (optional)

Request Example

curl -X POST https://api.cqtai.com/api/cqt/generator/hunyuan \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "hunyuan-3d-3.1",
    "prompt": "a cute cartoon robot toy"
  }'
# -> { "code":200, "data":"<taskId>" }

Response Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "35bbd39a8a8845ea9219ad14fb5c7ebb",
    "resultUrl": "https://cdn.novapi.ai/hunyuan/1791952967535_6fbe6551cce24f50b37abb4c8b98fe69.glb,https://cdn.novapi.ai/hunyuan/1791952981971_35661c5ff3444326ad94edb7f72658b9.obj,https://cdn.novapi.ai/hunyuan/1791952994797_e4f656e4defb417ea7e331711c6470ee.zip,https://cdn.novapi.ai/hunyuan/1791952998283_7afccca5e13c413e954ae7afcddbcf80.png,https://cdn.novapi.ai/hunyuan/1791952999211_aff98817cf204466963279f8c9d10444.png",
    "status": "succeeded",
    "errorMsg": null,
    "createTime": "2026-10-14 12:37:59",
    "completeTime": "2026-10-14 12:43:20"
  }
}

Response Fields

Field	Type	Description
code	number	200 means success
data.id	string	Task ID (taskId)
data.status	string	queued / running / succeeded / failed
data.errorMsg	string \| null	Failure reason; null on success
data.resultUrl	string	Comma-separated files: 3D model files first (full asset: GLB, OBJ, OBJ zip; geometry: GLB, FBX), then preview PNGs