Skip to content

Hy World Model โ€‹

Updated

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 โ€‹

ItemValue
ModelNameHunyuan
ModelVersion3d_2.0
SceneType3d_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 โ€‹

MethodInputUse Case
Space generationText or imageGame backgrounds, VR spaces, interior design proposals
Space reconstructionImage of a real spaceDigital reproduction of a space

Result File Types โ€‹

FieldResult
scene_url3D Gaussian Splatting scene
point_urlPLY point cloud
mesh_urlMesh model
mesh_simplified_urlLightweight Mesh model
position_infoCoordinate and orientation information

Mesh and scene data are used for integration with Unity / Unreal Engine.

Request Parameters โ€‹

ParameterRequiredTypeDescription
ModelNameRequiredStringFixed value Hunyuan
ModelVersionOptionalString3d_2.0
SceneTypeRequiredString3d_scene
PromptRequiredStringSpace description prompt
ImageUrlOptionalStringReference image. Used for reconstructing a real-world space

Request Example โ€‹

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"
}

Response Example โ€‹

The completion response contains a URL for each type of output.

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>"
  }
}

Special Configuration โ€‹

Supported Modes โ€‹

MethodInputResult
World generationPrompt or imageExplorable 3D space
World reconstructionReal-world image3D replica of a real space

Output Specifications โ€‹

ItemValue
Format3DGS(.spz), Mesh(GLB / FBX / OBJ), point cloud(.ply)
Engine compatibilityNative support for Unity and Unreal Engine
Additional outputSimplified 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.

Built with VitePress ยท Deployed on Tencent EdgeOne Pages