Hy World Model

Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcVideoTask

기본 정보

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

프롬프트나 이미지로 탐색 가능한 공간을 만듭니다.

공간 구성

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

생성과 재구성

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

요청 파라미터

파라미터	필수	타입	설명
ModelName	필수	String	고정값 Hunyuan
ModelVersion	선택	String	3d_2.0
SceneType	필수	String	3d_scene
Prompt	필수	String	공간 묘사 프롬프트
FileInfos.N	선택	Array	기준 이미지. Usage=FirstFrame
OutputConfig.Duration	선택	Integer	탐색 영상 길이(초)

요청 예시

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

응답 예시

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

특수 설정

지원 모드

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

출력 규격

항목	값
API 결과	생성한 공간을 보여주는 영상
파일 URL	AigcVideoTask.Output.FileInfos.FileUrl
영상 정보	MetaData.Width / Height / Duration

추가 옵션

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

3d-world-scene-2.0 별칭은 MPS 전용입니다. VOD 경로에서는 ModelVersion=3d_2.0 + SceneType=3d_scene 조합만 사용할 수 있습니다.