混元文生3D模型v3.1

POST

/openapi/v2/hunyuan3d-v3.1/text-to-3d

面向生产力场景的超高清几何生成模型。其核心优势在于拥有 1536³ 的极致几何分辨率与 36 亿体素规模，彻底告别了早期模型常见的表面模糊问题。该版本引入了 PartGen 1.5 组件化生成技术，能够自动实现语义拆解（如车辆轮子可独立旋转），极大简化了下游的游戏绑定工作流。通过几何与纹理的深度解耦，模型在生成复杂结构（如机械零件或高精手办）时，展现出了工业级的结构精准度与材质还原力。

请求参数

Authorization

Header 参数

Body 参数application/json必填

示例

{
    "prompt": "一个极其精细的工业级科幻侦察无人机。它拥有四个铰接式的旋翼臂，每个臂上都有独立的螺旋桨。机身中央是一个带有玻璃透镜的光学传感器吊舱，周围有裸露的液压管线和金色铜导线。机身材质为做旧的金属，带有生锈痕迹和划痕，底部有橡胶材质的着陆缓冲垫。整体结构需要符合空气动力学，零件之间有清晰的物理分界。",
    "faceCount": 500000,
    "enablePbr": false,
    "generateType": "Normal"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/openapi/v2/hunyuan3d-v3.1/text-to-3d' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "一个极其精细的工业级科幻侦察无人机。它拥有四个铰接式的旋翼臂，每个臂上都有独立的螺旋桨。机身中央是一个带有玻璃透镜的光学传感器吊舱，周围有裸露的液压管线和金色铜导线。机身材质为做旧的金属，带有生锈痕迹和划痕，底部有橡胶材质的着陆缓冲垫。整体结构需要符合空气动力学，零件之间有清晰的物理分界。",
    "faceCount": 500000,
    "enablePbr": false,
    "generateType": "Normal"
}'

返回响应

🟢200成功

application/json

任务结果查询接口：/openapi/v2/query

Body

示例

提交任务响应示例任务完成（查询状态接口）响应示例

{
    "taskId": "2013508786110730241",
    "status": "RUNNING",
    "errorCode": "",
    "errorMessage": "",
    "results": null,
    "clientId": "f828b9af25161bc066ef152db7b29ccc",
    "promptTips": "{\"result\": true, \"error\": null, \"outputs_to_execute\": [\"4\"], \"node_errors\": {}}"
}

修改于 2026-03-30 02:15:59

可灵对口型-视频生成

hitem3d-v15/image-to-3d