Hy World Model โ
Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcVideoTask
Hy World Model is a 3D space generation capability: it creates explorable 3D spaces from text or images, and can also reconstruct a space from photos of a real location. It suits game backdrops, VR spaces, and interior-design drafts.
Basic information โ
| Item | Value |
|---|---|
| ModelName | Hunyuan |
| ModelVersion | 3d_2.0 |
| SceneType | 3d_scene |
Creates an explorable space from a prompt or an image.
Composing the space โ
Write the layout, structures, materials, lighting, and style of the space concretely in the prompt. Image input is used as the baseline that specifies the appearance and layout of the space.
Generation and reconstruction โ
| Mode | Input | Use |
|---|---|---|
| Space generation | Text or image | Game backgrounds, VR spaces, interior design drafts |
| Space reconstruction | Images of a real space | Digital space reproduction |
Request parameters โ
| Parameter | Required | Type | Description |
|---|---|---|---|
ModelName | Required | String | Fixed value Hunyuan |
ModelVersion | Optional | String | 3d_2.0 |
SceneType | Required | String | 3d_scene |
Prompt | Required | String | The prompt describing the space |
FileInfos.N | Optional | Array | Baseline image. Usage=FirstFrame |
OutputConfig.Duration | Optional | Integer | Length of the exploration video (seconds) |
Request example โ
{
"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"
}
}Response example โ
{
"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
}
}
]
}
}
}Special settings โ
Supported modes โ
| Mode | Input | Result |
|---|---|---|
| World generation | Prompt or image | An explorable 3D space |
| World reconstruction | Live-action images | A 3D replica of a real space |
Output specs โ
| Item | Value |
|---|---|
| API result | A video showing the generated space |
| File URL | AigcVideoTask.Output.FileInfos.FileUrl |
| Video information | MetaData.Width / Height / Duration |
Additional options โ
3D scenes take longer to process than other generation types and have a limit on the number of concurrently running tasks. Adjust your polling interval to match the processing time. VOD model versions
The 3d-world-scene-2.0 alias is exclusive to MPS. On the VOD path, only the ModelVersion=3d_2.0 + SceneType=3d_scene combination is available.