Hy World Model
Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcVideoTask
Hy World Model 是3D 空间生成能力,可用文本或图片生成可探索的 3D 空间,也可用真实空间的照片进行空间重构。适用于游戏背景、VR 空间与室内设计草案。
基本信息
| 项目 | 值 |
|---|---|
| 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 | 探索视频时长(秒) |
请求示例
json
{
"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"
}
}响应示例
json
{
"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 组合。