跳到内容

Hy World Model ​

更新时间

Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcVideoTask

Hy World Model 是3D 空间生成能力,可用文本或图片生成可探索的 3D 空间,也可用真实空间的照片进行空间重构。适用于游戏背景、VR 空间与室内设计草案。

基本信息 ​

项目值
ModelNameHunyuan
ModelVersion3d_2.0
SceneType3d_scene

基于 Hunyuan 世界模型生成可探索的 3D 空间。支持输入提示词或图片。

空间构成 ​

在提示词中具体描述空间的布局、结构物、材质、光照与风格。图片输入用作指定空间外观与布局的基准。

生成与重建 ​

方式输入应用
空间生成文本或图片游戏背景、VR 空间、室内设计方案
空间重建真实空间的图片数字空间还原

结果文件区分 ​

字段结果
scene_url3D Gaussian Splatting 场景
point_urlPLY 点云
mesh_urlMesh 模型
mesh_simplified_url轻量 Mesh 模型
position_info坐标与朝向信息

Mesh 与场景数据用于对接 Unity / Unreal Engine。

请求参数 ​

参数必填类型说明
ModelName必填String固定值 Hunyuan
ModelVersion选填String3d_2.0
SceneType必填String3d_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 方式中的一种。

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages