Hy World Model
Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcVideoTask
Hy World Model 是3D 空间生成能力,可用文本或图片生成可探索的 3D 空间,也可用真实空间的照片进行空间重构。适用于游戏背景、VR 空间与室内设计草案。
基本信息
| 项目 | 值 |
|---|---|
| ModelName | Hunyuan |
| ModelVersion | 3d_2.0 |
| SceneType | 3d_scene |
基于 Hunyuan 世界模型生成可探索的 3D 空间。支持输入提示词或图片。
空间构成
在提示词中具体描述空间的布局、结构物、材质、光照与风格。图片输入用作指定空间外观与布局的基准。
生成与重建
| 方式 | 输入 | 应用 |
|---|---|---|
| 空间生成 | 文本或图片 | 游戏背景、VR 空间、室内设计方案 |
| 空间重建 | 真实空间的图片 | 数字空间还原 |
结果文件区分
| 字段 | 结果 |
|---|---|
scene_url | 3D Gaussian Splatting 场景 |
point_url | PLY 点云 |
mesh_url | Mesh 模型 |
mesh_simplified_url | 轻量 Mesh 模型 |
position_info | 坐标与朝向信息 |
Mesh 与场景数据用于对接 Unity / Unreal Engine。
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
ModelName | 必填 | String | 固定值 Hunyuan |
ModelVersion | 选填 | String | 3d_2.0 |
SceneType | 必填 | String | 3d_scene |
Prompt | 必填 | String | 空间描述提示词 |
ImageUrl | 选填 | String | 基准图片。用于真实空间重建 |
请求示例
json
{
"ModelName": "Hunyuan",
"ModelVersion": "3d_2.0",
"SceneType": "3d_scene",
"Prompt": "generate a walkable 3D world from this image",
"ImageUrl": "https://<cdn>/scene.png",
"Operator": "admin"
}响应示例
完成响应中会分别包含各类结果的 URL。
json
{
"Response": {
"Message": "ok",
"Status": "DONE",
"scene_url": "https://<bucket>.cos.<region>.myqcloud.com/<scene>.spz",
"point_url": "https://<bucket>.cos.<region>.myqcloud.com/<points>.ply",
"mesh_url": "https://<bucket>.cos.<region>.myqcloud.com/<mesh>.glb",
"mesh_simplified_url": "https://<bucket>.cos.<region>.myqcloud.com/<mesh-lite>.glb",
"position_info": "{\"up_direction\":[0,1,0]}",
"RequestId": "<request-id>"
}
}特殊配置
支持模式
| 方式 | 输入 | 结果 |
|---|---|---|
| 世界生成 | 提示词或图片 | 可探索的 3D 空间 |
| 世界重建 | 实拍图片 | 真实空间的 3D 复制 |
输出规格
| 项目 | 值 |
|---|---|
| 格式 | 3DGS(.spz)、Mesh(GLB / FBX / OBJ)、点云(.ply) |
| 引擎兼容 | 原生支持 Unity、Unreal Engine |
| 附加输出 | 简化 Mesh、位置信息(position_info) |
附加选项
3D 场景的处理时间长于其他生成任务,且并发执行任务数存在限制。请根据处理时间调整轮询间隔。
ModelVersion world 专用写法
MPS 场景生成使用 SceneType 方式或 ModelVersion=3d-world-scene-2.0 方式中的一种。