跳到内容

Hy World Model ​

更新时间

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

Hy World Model 是3D 空间生成能力,可用文本或图片生成可探索的 3D 空间,也可用真实空间的照片进行空间重构。适用于游戏背景、VR 空间与室内设计草案。

基本信息 ​

项目值
ModelNameHunyuan
ModelVersion3d_2.0
SceneType3d_scene

用提示词或图片生成可探索的空间。

空间构成 ​

请在提示词中具体写出空间的布局、构造物、材质、光照与风格。图片输入用作指定空间外观与布局的基准。

生成与重构 ​

方式输入应用
空间生成文本或图片游戏背景、VR 空间、室内设计草案
空间重构真实空间的图片数字空间复现

请求参数 ​

参数必填类型说明
ModelName必填String固定值 Hunyuan
ModelVersion可选String3d_2.0
SceneType必填String3d_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 结果展示所生成空间的视频
文件 URLAigcVideoTask.Output.FileInfos.FileUrl
视频信息MetaData.Width / Height / Duration

附加选项 ​

3D 场景比其他生成的处理时间更长,并且有并发执行任务数限制。请配合处理时间调整轮询间隔。VOD 模型版本

3d-world-scene-2.0 别名是 MPS 专用的。在 VOD 路径下,只能使用 ModelVersion=3d_2.0 + SceneType=3d_scene 组合。

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages