MPS APILast Updated 2026-09-07

Hy World Model

On this page

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

기본 정보

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

Hunyuan 세계 모델로 탐색 가능한 3D 공간을 생성합니다. 프롬프트나 이미지를 입력으로 받습니다.

공간 구성

프롬프트에는 공간의 배치, 구조물, 재질, 조명과 스타일을 구체적으로 적습니다. 이미지 입력은 공간의 외형과 배치를 지정하는 기준으로 사용합니다.

생성과 재구성

방식	입력	활용
공간 생성	텍스트 또는 이미지	게임 배경, VR 공간, 인테리어 시안
공간 재구성	실제 공간의 이미지	디지털 공간 재현

결과 파일 구분

필드	결과
`scene_url`	3D Gaussian Splatting 씬
`point_url`	PLY 포인트 클라우드
`mesh_url`	Mesh 모델
`mesh_simplified_url`	경량 Mesh 모델
`position_info`	좌표와 방향 정보

Mesh와 씬 데이터는 Unity / Unreal Engine 연동에 사용합니다.

요청 파라미터

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

요청 예시

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

응답 예시

완료 응답에는 결과물 종류별 URL이 각각 들어옵니다.

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

특수 설정

지원 모드

방식	입력	결과
세계 생성	프롬프트 또는 이미지	탐색 가능한 3D 공간
세계 재구성	실사 이미지	실제 공간의 3D 복제

출력 사양

항목	값
포맷	3DGS(`.spz`), Mesh(GLB / FBX / OBJ), 포인트 클라우드(`.ply`)
엔진 호환	Unity, Unreal Engine 네이티브 지원
부가 출력	단순화 Mesh, 위치 정보(`position_info`)

추가 옵션

3D 씬은 다른 생성보다 처리 시간이 길고 동시 실행 태스크 수 제한이 있습니다. 처리 시간에 맞춰 폴링 간격을 조절하세요.

ModelVersion world 전용 표기

MPS 씬 생성은 SceneType 방식 또는 ModelVersion=3d-world-scene-2.0 방식 중 하나를 사용합니다.