Hy World Model
On this page
Endpoint: POST https://vod.intl.tencentcloudapi.com
Action: 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 | 탐색 영상 길이(초) |
요청 예시
LANGUAGE
{
"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"
}
}응답 예시
LANGUAGE
{
"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 조합만 사용할 수 있습니다.