Tencent Hunyuan 3D 专业版
tencent/hunyuan-3d-pro
异步任务：POST /v1/tasks/generations 提交 → GET /v1/tasks/generations/{request_id} 轮询结果（POST 发送后 request_id 自动填入 GET）。
BASE URL
https://router.shengsuanyun.com/api认证方式
Authorization: Bearer YOUR_API_KEY端点列表
POST/v1/tasks/generations腾讯混元 3D 生成-异步
异步任务：POST 提交后返回 request_id，再用 GET /v1/tasks/generations/{request_id} 轮询结果。
请求体
application/json
union
anyOf · 1
| 字段 | 类型 | 说明 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
mode | string | |||||||||||||
prompt | stringtextarea | 最多支持1024个utf-8字符。与image_url/image_base64二选一 | ||||||||||||
image_url | string | 与prompt二选一，与image_base64互斥 | ||||||||||||
image_base64 | string | 与prompt二选一，与image_url互斥 | ||||||||||||
multi_view_images | array | 可选的多视角图片数组展开结构可选的多视角图片数组
数组元素
| ||||||||||||
enable_pbr | boolean | |||||||||||||
face_count | integer | 默认500000，范围40000-1500000 | ||||||||||||
generate_type | string | normal:带纹理模型, lowpoly:智能减面, geometry:白模, sketch:草图生成 可选值："normal" · "lowpoly" · "geometry" · "sketch" | ||||||||||||
polygon_type | string | 仅在generate_type为lowpoly时生效 可选值："triangle" · "quadrilateral" | ||||||||||||
model必填 | string | 路由模型，本页固定为 tencent/hunyuan-3d-pro |
anyOf · 2
| 字段 | 类型 | 说明 |
|---|---|---|
mode | string | |
prompt | stringtextarea | 最多支持200个utf-8字符。与image_url/image_base64二选一 |
image_url | string | 与prompt二选一，与image_base64互斥 |
image_base64 | string | 与prompt二选一，与image_url互斥 |
result_format | string | 生成模型文件格式，默认OBJ 可选值："OBJ" · "GLB" · "STL" · "USDZ" · "FBX" · "MP4" |
enable_pbr | boolean | |
enable_geometry | boolean | 生成不带纹理的3D模型（白模），开启时不支持OBJ格式 |
model必填 | string | 路由模型，本页固定为 tencent/hunyuan-3d-pro |
{
"enable_geometry": false,
"enable_pbr": false,
"mode": "rapid",
"model": "tencent/hunyuan-3d-pro",
"prompt": "猫头鹰，大眼睛，深棕色",
"result_format": "GLB"
}请求示例
参考地址：https://router.shengsuanyun.com/api。路径参数与凭据需替换；非 JSON 请求体需按对应格式准备。
curl -X POST 'https://router.shengsuanyun.com/api/v1/tasks/generations' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
--data '{
"enable_geometry": false,
"enable_pbr": false,
"mode": "rapid",
"model": "tencent/hunyuan-3d-pro",
"prompt": "猫头鹰，大眼睛，深棕色",
"result_format": "GLB"
}'响应
200 提交成功，返回 request_id / task_id
application/json
未提供结构定义。
{
"code": "success",
"message": "",
"data": {
"request_id": "REQ_xxx",
"task_id": "TASK_xxx",
"action": "GENERATION",
"status": "PENDING",
"progress": "0%"
}
}400 请求参数错误
401 未授权（API Key 无效）
429 请求过于频繁
500 服务器内部错误
GET/v1/tasks/generations/{request_id}查询异步任务状态与产物
通过 POST /v1/tasks/generations 返回的 request_id 轮询任务状态、进度与产物 URL（image_urls / video_urls / audio_urls / file_urls / text）。下方「在线测试」填入 request_id 即可发送查询；若上方 POST 已发送成功，request_id 会自动填入。
请求参数
| 参数 | 位置 / 类型 | 说明 |
|---|---|---|
request_id必填 | path / string | POST /v1/tasks/generations 返回的请求 ID |
请求示例
参考地址：https://router.shengsuanyun.com/api。路径参数与凭据需替换；非 JSON 请求体需按对应格式准备。
curl -X GET 'https://router.shengsuanyun.com/api/v1/tasks/generations/{request_id}' \
-H 'Authorization: Bearer YOUR_API_KEY'响应
200 任务状态与产物
application/json
未提供结构定义。
{
"file_urls": [
"https://oss.shengsuanyun.com/example/modelinfo/252/2025-12-22_10:55:49_output_2.glb"
],
"image_urls": [
"https://oss.shengsuanyun.com/example/modelinfo/252/2025-12-22_10:55:49_output_1.png"
],
"progress": 100
}