Hunyuan3D 2.0 API

CometAPI
AnnaAug 17, 2025
Hunyuan3D 2.0 API

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.59154.639289.2870.787
闭源顶尖 13.60055.866305.9220.779
闭源 23.36849.744294.6280.806
闭源 33.21851.574295.6910.799
Hunyuan3D 2.03.19349.165282.4290.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/

使用方法

  1. 选择“Hunyuan3D-2”端点发送 API 请求并设置请求体。请求方法与请求体请参见我们网站的 API 文档。我们的网站也提供 Apifox 测试以供方便使用。
  2. 将 <YOUR_API_KEY> 替换为您账户中的实际 CometAPI 密钥。
  3. 将您的问题或请求插入 content 字段——模型将对此进行响应。
  4. . 处理 API 响应以获取生成的答案。

CometAPI 提供完全兼容的 REST API—便于无缝迁移。更多关键细节见 API 文档:

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" }'
阅读更多

一个 API 中超 500 个模型

最高 20% 折扣