Hunyuan 3D v3.1 Pro Image to 3D API

hunyuan-3d/v3.1/pro/image-to-3d

Hunyuan 3D v3.1 Pro Image to 3D 将正面图转化为三维模型,提供七个附加视角、面数与 PBR 材质控制。搭配同一物体的对应角度图片,为各侧形体重建补充视觉依据。

Input
必填
Image Urls

拖拽文件、粘贴剪贴板素材,或输入 URL。 提供恰好一个公开可访问的 HTTP(S) 图片 URL。

1/1 个素材

可选
可选
可选
可选
附加视角
可选
Back Image Url

拖拽文件、粘贴剪贴板素材,或输入 URL。 提供同一物体背面视角的公开 HTTP(S) 图片 URL。

可选
Left Image Url

拖拽文件、粘贴剪贴板素材,或输入 URL。 提供同一物体左侧视角的公开 HTTP(S) 图片 URL。

可选
Right Image Url

拖拽文件、粘贴剪贴板素材,或输入 URL。 提供同一物体右侧视角的公开 HTTP(S) 图片 URL。

可选
Top Image Url

拖拽文件、粘贴剪贴板素材,或输入 URL。 提供同一物体顶部视角的公开 HTTP(S) 图片 URL。

可选
Bottom Image Url

拖拽文件、粘贴剪贴板素材,或输入 URL。 提供同一物体底部视角的公开 HTTP(S) 图片 URL。

可选
Left Front Image Url

拖拽文件、粘贴剪贴板素材,或输入 URL。 提供同一物体左前方视角的公开 HTTP(S) 图片 URL。

可选
Right Front Image Url

拖拽文件、粘贴剪贴板素材,或输入 URL。 提供同一物体右前方视角的公开 HTTP(S) 图片 URL。

Output模型已就绪
正在加载 3D 预览…
当前费用: 60 credits
继续使用

示例

蜷缩犰狳

蜷缩犰狳

Hunyuan 3D v3.1 Pro Image to 3D

Hunyuan 3D v3.1 Pro Image to 3D 是腾讯将物体图片转化为三维资产的模型。正面主图可搭配七个具名视角,分别描述背面、两侧、顶部、底部和正面斜向部位;目标面数与材质控制项用于调整生成配置,便于开展产品展示、道具评审和三维软件中的后续编辑。

为什么选择 Hunyuan 3D v3.1 Pro Image to 3D?

  • 提供八个角度的视觉参考使用一张正面图与七个具名附加视角,分别补充物体不同侧面的视觉信息。

  • 选择目标网格规模将目标面数设置在 40000–1500000 范围内,为模型生成指定网格复杂度。

  • 分别检查几何与表面选择 Geometry 生成白模,或使用 Normal 并开启 PBR,随模型生成材质。

生成参数

参数要求作用与用法
prompt可选

可填写非空文字描述,补充物体信息。

image_urls必填

提供恰好一个公开可访问的 HTTP(S) 图片 URL。

generate_type可选

选择 Normal 生成纹理模型,或选择 Geometry 生成几何白模。

NormalGeometry
enable_pbr可选

在纹理模式中设为 true 生成 PBR 材质,几何模式优先于此设置。

face_count可选

输入 40000–1500000 的整数目标面数,默认 500000。

默认值500000
back_image_url可选

提供同一物体背面视角的公开 HTTP(S) 图片 URL。

left_image_url可选

提供同一物体左侧视角的公开 HTTP(S) 图片 URL。

right_image_url可选

提供同一物体右侧视角的公开 HTTP(S) 图片 URL。

top_image_url可选

提供同一物体顶部视角的公开 HTTP(S) 图片 URL。

bottom_image_url可选

提供同一物体底部视角的公开 HTTP(S) 图片 URL。

left_front_image_url可选

提供同一物体左前方视角的公开 HTTP(S) 图片 URL。

right_front_image_url可选

提供同一物体右前方视角的公开 HTTP(S) 图片 URL。

如何使用

  1. 准备输入在 Image Urls 中提供一张正面主图,在附加视角区域填入同一物体的对应方向图片。

  2. 设置几何与材质设置 Generate Type 与 Face Count,并按材质需求调整 Enable Pbr。

  3. 提交生成查看当前费用后选择 Run,在输出区跟踪任务状态。

  4. 检查并下载预览返回的三维模型,并下载模型、纹理与配套文件。

生成费用

基础生成 $0.300,有效附加项累加;几何模式仅计入基础费及适用的面数、多视图费用。

生成类型费用计费单位
基础生成$0.300 · 60 credits每次生成
PBR 材质+$0.120 · 24 credits纹理模式开启 PBR 时
自定义面数+$0.120 · 24 creditsface_count 与 500000 不同时
多视图参考+$0.120 · 24 credits提供任意附加视角时收取一次

适用场景

  • 道具概念评审从参考图片生成物体,评审其轮廓与主要部件。

  • 产品视觉准备检查模型与配套材质,在三维软件中准备展示场景。

  • 场景资产编辑下载返回的模型与配套文件,继续调整比例、摆放与表面效果。

使用建议

  • 选择主体清晰、轮廓完整的物体图片。
  • 使用几何模式集中评审物体形状。
  • 使用纹理模式与 PBR 设置检查材质方向。
  • 附加视角使用同一物体并保持取景与光照一致。

输出文件说明

  • 根据返回的 label、format 和 file_type 识别模型、预览、纹理与材质文件。

Hunyuan 3D v3.1 Pro Image to 3D API 常见问题

Hunyuan 3D v3.1 Pro Image to 3D API 是什么?

Hunyuan 3D v3.1 Pro Image to 3D 是腾讯用于根据参考图片生成三维物体的模型。使用一张正面图与七个具名附加视角,分别补充物体不同侧面的视觉信息。目标面数与生成模式共同控制几何,PBR 设置用于纹理模式的材质生成。你可以通过 API 进行程序化调用,也可以在上方体验区直接在线试用。

Hunyuan 3D v3.1 Pro Image to 3D 的主图怎样选择?

在 image_urls 中放入一张正面图片。选择主体清晰、构图完整的单个物体,让轮廓和主要部件容易辨认,并为附加视角保持一致的主体比例。

Hunyuan 3D v3.1 Pro Image to 3D 可以使用几个视角?

提供一张主图,并搭配最多七个具名附加视角:back、left、right、top、bottom、left_front 和 right_front。每个附加视角使用各自的图片 URL 字段。

Hunyuan 3D v3.1 Pro Image to 3D 的多视角图片怎样准备?

使用同一物体的图片,保持材质、光照与主体比例一致。按拍摄方向将图片填入对应字段,让各视角的取景范围相近,便于共同描述物体。

Hunyuan 3D v3.1 Pro Image to 3D 的正面斜向视角怎样使用?

left_front_image_url 和 right_front_image_url 分别提供左前方与右前方的参考。用这些视角展示正面到侧面的过渡,例如把手、转角或向外突出的部件。

Hunyuan 3D v3.1 Pro Image to 3D 怎样控制网格复杂度?

将 face_count 设置为 40000–1500000 的整数,默认目标为 500000。生成后在三维软件中检查网格,并结合场景需求评估模型复杂度。

Hunyuan 3D v3.1 Pro Image to 3D 的几何与 PBR 模式怎样选择?

选择 Normal 并设置 enable_pbr: true,可生成带 PBR 材质的纹理模型。选择 Geometry 可生成用于形体检查的白模,此模式优先于材质设置。

Hunyuan 3D v3.1 Pro Image to 3D 与 Rapid 怎样选择?

需要具名多视角参考和目标面数控制时,选择 Pro Image to 3D。Rapid Image to 3D 使用一张参考图,提供几何模式与 PBR 控制项。