Hy World Model โ
Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcVideoTask
Hy World Model is a 3D space generation capability: it creates explorable 3D spaces from text or images, and can also reconstruct a space from photos of a real location. It suits game backdrops, VR spaces, and interior-design drafts.
Basic Information โ
| Item | Value |
|---|---|
| ModelName | Hunyuan |
| ModelVersion | 3d_2.0 |
| SceneType | 3d_scene |
Uses the Hunyuan world model to generate an explorable 3D space. It accepts a prompt or an image as input.
Space Composition โ
Describe the layout, structures, materials, lighting, and style of the space in detail in the prompt. Image input is used as a basis for specifying the appearance and layout of the space.
Generation and Reconstruction โ
| Method | Input | Use Case |
|---|---|---|
| Space generation | Text or image | Game backgrounds, VR spaces, interior design proposals |
| Space reconstruction | Image of a real space | Digital reproduction of a space |
Result File Types โ
| Field | Result |
|---|---|
scene_url | 3D Gaussian Splatting scene |
point_url | PLY point cloud |
mesh_url | Mesh model |
mesh_simplified_url | Lightweight Mesh model |
position_info | Coordinate and orientation information |
Mesh and scene data are used for integration with Unity / Unreal Engine.
Request Parameters โ
| Parameter | Required | Type | Description |
|---|---|---|---|
ModelName | Required | String | Fixed value Hunyuan |
ModelVersion | Optional | String | 3d_2.0 |
SceneType | Required | String | 3d_scene |
Prompt | Required | String | Space description prompt |
ImageUrl | Optional | String | Reference image. Used for reconstructing a real-world space |
Request Example โ
{
"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"
}Response Example โ
The completion response contains a URL for each type of output.
{
"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>"
}
}Special Configuration โ
Supported Modes โ
| Method | Input | Result |
|---|---|---|
| World generation | Prompt or image | Explorable 3D space |
| World reconstruction | Real-world image | 3D replica of a real space |
Output Specifications โ
| Item | Value |
|---|---|
| Format | 3DGS(.spz), Mesh(GLB / FBX / OBJ), point cloud(.ply) |
| Engine compatibility | Native support for Unity and Unreal Engine |
| Additional output | Simplified Mesh, position information(position_info) |
Additional Options โ
3D scenes take longer to process than other generation tasks and have a limit on the number of concurrent tasks. Adjust the polling interval to match the processing time.
Notation Specific to ModelVersion world
MPS scene generation uses either the SceneType method or the ModelVersion=3d-world-scene-2.0 method.