Skip to content

Hy 3D Panorama ​

Updated

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

Hy 3D Panorama is a 3D / panorama generation capability: from text or a single image, it generates a 360° equirectangular (ERP) panorama. It is suited to VR / AR backdrops, video backgrounds, and virtual studios.

Basic Information ​

ItemValue
ModelNameHunyuan
ModelVersion3d_2.0
SceneType3d_panorama

Uses the Hunyuan world model to generate a 360° equirectangular (ERP) panorama image.

Output Specifications ​

ItemValue
Result360° ERP panorama image
InputText or image 1 image
Use CaseVR / AR backgrounds, video backgrounds, virtual studio

Request Parameters ​

ParameterRequiredTypeDescription
ModelNameRequiredStringFixed value Hunyuan
ModelVersionOptionalString3d_2.0
SceneTypeRequiredString3d_panorama
PromptRequiredStringSpace description prompt
ImageUrlOptionalStringReference image. Used when reproducing a real-world space

Request Example ​

json
{
  "ModelName": "Hunyuan",
  "ModelVersion": "3d_2.0",
  "SceneType": "3d_panorama",
  "Prompt": "a 360 panorama of a fantasy castle on a cliff at golden hour",
  "Operator": "admin"
}

Response Example ​

json
{
  "Response": {
    "Status": "DONE",
    "Message": "ok",
    "ImageUrls": [
      "https://<bucket>.cos.<region>.myqcloud.com/<file>.png"
    ],
    "RequestId": "<request-id>"
  }
}

360° Panorama ​

json
{
  "ModelName": "Hunyuan",
  "ModelVersion": "3d_2.0",
  "SceneType": "3d_panorama",
  "Prompt": "a 360 panorama of a fantasy castle on a cliff",
  "Operator": "admin"
}

Use DescribeAigcImageTask for queries.

json
{
  "Response": {
    "Message": "ok",
    "Status": "DONE",
    "ImageUrls": [
      "https://<bucket>.cos.<region>.myqcloud.com/<file>.png"
    ],
    "RequestId": "<request-id>"
  }
}

Special Configuration ​

Additional Options ​

Notation Specific to ModelVersion world

MPS panorama generation uses either the SceneType method or the ModelVersion=3d-world-panorama-2.0 method.

Built with VitePress · Deployed on Tencent EdgeOne Pages