Skip to content

Hy World Model โ€‹

Updated

Endpoint: POST https://vod.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

Creates an explorable space from a prompt or an image.

Composing the space โ€‹

Write the layout, structures, materials, lighting, and style of the space concretely in the prompt. Image input is used as the baseline that specifies the appearance and layout of the space.

Generation and reconstruction โ€‹

ModeInputUse
Space generationText or imageGame backgrounds, VR spaces, interior design drafts
Space reconstructionImages of a real spaceDigital space reproduction

Request parameters โ€‹

ParameterRequiredTypeDescription
ModelNameRequiredStringFixed value Hunyuan
ModelVersionOptionalString3d_2.0
SceneTypeRequiredString3d_scene
PromptRequiredStringThe prompt describing the space
FileInfos.NOptionalArrayBaseline image. Usage=FirstFrame
OutputConfig.DurationOptionalIntegerLength of the exploration video (seconds)

Request example โ€‹

json
{
  "SubAppId": 123456789,
  "ModelName": "Hunyuan",
  "ModelVersion": "3d_2.0",
  "SceneType": "3d_scene",
  "Prompt": "generate a walkable 3D world from this image",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Usage": "FirstFrame",
      "Url": "https://<cdn>/scene.png"
    }
  ],
  "OutputConfig": {
    "Duration": 8,
    "StorageMode": "Temporary"
  }
}

Response example โ€‹

json
{
  "AigcVideoTask": {
    "Status": "FINISH",
    "ErrCode": 0,
    "Progress": 100,
    "Output": {
      "FileInfos": [
        {
          "FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcVideoGenFile.mp4",
          "MetaData": {
            "Width": 1920,
            "Height": 1080,
            "Duration": 8.0
          }
        }
      ]
    }
  }
}

Special settings โ€‹

Supported modes โ€‹

ModeInputResult
World generationPrompt or imageAn explorable 3D space
World reconstructionLive-action imagesA 3D replica of a real space

Output specs โ€‹

ItemValue
API resultA video showing the generated space
File URLAigcVideoTask.Output.FileInfos.FileUrl
Video informationMetaData.Width / Height / Duration

Additional options โ€‹

3D scenes take longer to process than other generation types and have a limit on the number of concurrently running tasks. Adjust your polling interval to match the processing time. VOD model versions

The 3d-world-scene-2.0 alias is exclusive to MPS. On the VOD path, only the ModelVersion=3d_2.0 + SceneType=3d_scene combination is available.

Built with VitePress ยท Deployed on Tencent EdgeOne Pages