MPS APILast Updated 2026-09-07

Hy 3D Panorama

On this page

Endpoint: POST https://mps.intl.tencentcloudapi.com
Action: CreateAigcImageTask

기본 정보

항목	값
ModelName	`Hunyuan`
ModelVersion	`3d_2.0`
SceneType	`3d_panorama`

Hunyuan 세계 모델로 360도 등장방형(ERP) 파노라마 이미지를 생성합니다.

출력 규격

항목	값
결과	`360`° ERP 파노라마 이미지
입력	텍스트 또는 이미지 `1장`
용도	VR / AR 배경, 영상 배경, 가상 스튜디오

요청 파라미터

파라미터	필수	타입	설명
`ModelName`	필수	String	고정값 `Hunyuan`
`ModelVersion`	선택	String	`3d_2.0`
`SceneType`	필수	String	`3d_panorama`
`Prompt`	필수	String	공간 묘사 프롬프트
`ImageUrl`	선택	String	기준 이미지. 실사 공간을 재현할 때 사용

요청 예시

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

응답 예시

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

360도 파노라마

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

조회는 DescribeAigcImageTask를 사용합니다.

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

특수 설정

추가 옵션

ModelVersion world 전용 표기

MPS 파노라마 생성은 SceneType 방식 또는 ModelVersion=3d-world-panorama-2.0 방식 중 하나를 사용합니다.