Hunyuan3D 2.0 是腾讯的先进的大规模 3D 生成式 AI 系统。基于扩散式架构,通过由形状生成与纹理合成构成的两阶段流水线,将文本描述或图像转化为细节丰富的 3D 资产——具有高质量纹理的网格。
关键特性(功能概述)
- 两阶段生成: 将几何(裸网格)与纹理合成(UV 映射 / PBR 纹理)解耦,以提升可控性与质量。
- 图像条件与文本条件模式: 支持单视图或多视图图像以及/或文本提示来引导形状与纹理。
- 高分辨率纹理: 支持大尺寸纹理输出(适配 2K–6K+ 工作流的配置)以及超分/增强步骤。关键词: 纹理分辨率、超分辨率、烘焙。
技术细节
- Shape generator (Hunyuan3D-DiT):扩散-Transformer 风格的模块,训练用于生成几何(根据版本采用八叉树/类八叉树或晶格表示),并优化几何与条件图像或文本提示的一致性。
- Texture synthesizer (Hunyuan3D-Paint / PBR synthesizer):第二个模型,生成带 UV 映射的纹理图集,并提供基于物理渲染输出(反照率、粗糙度、金属度贴图),使生成资产可即刻用于渲染器与游戏引擎。
- 解码与分辨率:后续版本提升几何分辨率(如更高的八叉树/晶格分辨率)与纹理尺寸(社区常用设置可导出多 K 级纹理)。
- 规模与模型大小:v2.5 的报告显示,从 2.0 到 2.5 在参数量与数据集规模上显著扩容,以提升几何精度与纹理真实度。
- Hunyuan3D-2.5 升级: LATTICE(最多 100 亿参数)带来更锐利、干净的几何;PBR 纹理流水线提升多视图一致性;社区笔记报告有 4K 级纹理。
计算与显存: 参考仓库注明形状生成约需 ~6 GB 显存,完整形状+纹理推理约需 ~16 GB(典型桌面 GPU)。
基准性能(v2.0 与其他模型对比)
| 模型 | CMMD ⬇ | FID_CLIP ⬇ | FID ⬇ | CLIP-score ⬆ |
|---|---|---|---|---|
| 开源顶尖 | 3.591 | 54.639 | 289.287 | 0.787 |
| 闭源顶尖 1 | 3.600 | 55.866 | 305.922 | 0.779 |
| 闭源 2 | 3.368 | 49.744 | 294.628 | 0.806 |
| 闭源 3 | 3.218 | 51.574 | 295.691 | 0.799 |
| Hunyuan3D 2.0 | 3.193 | 49.165 | 282.429 | 0.809 |
结果证实在几何细节与纹理真实感方面具有显著优势。
使用场景
- 输入模式:文本转 3D、图像转 3D、高阶版本支持多视图输入。
- 输出:高分辨率网格 + 高质量纹理(后续版本为 PBR)。
游戏原型与资产流水线: 快速从概念到带纹理网格的交付,减少道具/角色的美术迭代时间。关键词: 原型制作、游戏资产。
AR/VR / 虚拟制作: PBR 纹理与引擎兼容的导出,便于快速集成到交互场景与前期可视化。关键词: AR/VR、PBR、引擎就绪。
建筑与产品可视化: 从草图或情绪板图像生成风格化或真实的 3D 原型。关键词: 可视化、快速迭代。
教育/创作工具: 以易用方式讲授 3D 概念,并让创作者生成可进一步打磨的基础网格。关键词: 教育、创作工具。(社区示例与教程。)
限制与挑战
- 网格密度:三角形数量较高(最高约 ~600k),在生产流水线中需要进行重拓扑。
- 纹理细节:当输入分辨率较低时,精细细节(例如织物)可能出现模糊。
- 区域限制:受欧盟/GDPR 合规要求影响,使用受限;合规版本正在推进中。
- 接缝与光照不一致:纹理烘焙可能产生接缝或光照伪影,在单图输入时尤为明显;多视图输入与超分/修复可缓解但无法完全消除这些问题。
- 提示/条件敏感性: 与其他生成模型类似,提示语措辞与输入设置会显著影响结果;对于边缘情况与精细几何约束,可能需要迭代优化。
如何通过 CometAPI 调用 Hunyuan3D API
Hunyuan3D-2 在 CometAPI 的 API 价格,较官方价格便宜 20%:
| 价格 | $0.08000 |
必要步骤
- 登录 cometapi.com。如果您尚未成为我们的用户,请先注册。
- 获取接口的访问凭证 API Key。在个人中心的 API token 处点击“Add Token”,获得令牌密钥:sk-xxxxx 并提交。
- 获取该站点的 URL:https://api.cometapi.com/
使用方法
- 选择“
Hunyuan3D-2”端点发送 API 请求并设置请求体。请求方法与请求体请参见我们网站的 API 文档。我们的网站也提供 Apifox 测试以供方便使用。 - 将 <YOUR_API_KEY> 替换为您账户中的实际 CometAPI 密钥。
- 将您的问题或请求插入 content 字段——模型将对此进行响应。
- . 处理 API 响应以获取生成的答案。
CometAPI 提供完全兼容的 REST API—便于无缝迁移。更多关键细节见 API 文档:
- 端点: https://api.cometapi.com/v1/images/generations
- 模型参数:
Hunyuan3D-2 - 认证:
Bearer YOUR_CometAPI_API_KEY - Content-Type:
application/json。
curl --location
--request POST 'https://api.cometapi.com/v1/images/generations' \
--header 'Authorization: Bearer {{api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{ "model": "Hunyuan3D-2", "prompt": "A cute baby sea otter", "image": "https://filesystem.site/cdn/20250414/chxiLc2O45zoLT8BCrQ6WQlTvGDDnK.png" }'
