> For the complete documentation index, see [llms.txt](https://developer.hyper3d.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.hyper3d.ai/zh_cn/api-specification/overview_reset_v.md).

# Overview

### **请求工作流**

API生成模型消耗资源和时间，因此我们将其设计为异步的。这意味着你提交了一个生成任务后并不一定能立即得到结果。

一个典型的工作流程包括将任务提交到[Rodin 生成](/zh_cn/api-specification/rodin-generation_reset_v.md)/[Rodin Gen-2 生成](/zh_cn/api-specification/rodin-generation-gen2_reset_v.md)端点，[状态查询](/zh_cn/api-specification/check-status_reset_v.md)端点，以及[当任务完成后获取下载链接的](/zh_cn/api-specification/download-results_reset_v.md)端点。有关工作流的示例脚本请参阅[Minimal Example](/zh_cn/get-started/minimal-example.md)。

## **Rodin Gen-2**

Rodin Gen-2是我们目前最先进的3D生成模型。它采用了全新的[BANG架构](https://sites.google.com/view/bang7355608)，使用了前所未有的3D数据与参数量来训练，模型规模到达了10B量级。

相比之前的版本，Rodin Gen-2有如下特点：

* 4倍几何网格质量，平衡了表面细节与结构规整度
* 递归式分件生成，分了再分
* 支持通过烘焙法线，在低面模型下展示高面模型的细节
* 高清材质贴图

这些功能会在2025年相继完成API的上线，您也可以在[Hyper3D.AI](https://hyper3d.ai/)中提前使用。

## **Rodin Gen-1&1.5**

### **Rodin Sketch**

Rodin Sketch提供了快速生成3D模型，适用于早期的原型设计。它生成具有基本几何和纹理的模型，可以快速可视化或迭代。Rodin Sketch**仅提供GLB格式**的模型，因此它将是三角面模型。

### **Rodin Regular**

Rodin Regular生成具有自定义面数和高质量纹理的3D模型。它非常适合需要在细节和效率之间取得良好平衡的项目。纹理可以选择Shaded或PBR格式。生成的模型可以选择多种格式（如GLB,OBJ,FBX等等），并根据所选模型格式提供相对应的三角面或四角面模型。

#### High Pack Option

对于Rodin Regular,High Pack 选项可以生成更高分辨率(4K)的纹理和High-poly的模型。High-poly模型拥有更高的精度，它的面数是正常所选模型面数的16倍左右。

#### Image-to-3D 和 Text-to-3D

Rodin会根据您提交给[Rodin Generation](/zh_cn/api-specification/rodin-generation_reset_v.md)端点的参数的不同，选择不同的生成模式。当您将图片文件作为参数上传时，Rodin会选用Image-to-3D模式。当您没有上传任何图片文件时，则必须上传prompt，此时将会以Text-to-3D模式执行。

#### 多图片生成模型

对于 Rodin 的 Image-to-3D 生成，当你向 [Rodin Generation](/zh_cn/api-specification/rodin-generation_reset_v.md) 端点上传多于一张图片时，它会自动切换到多图像生成模型模式。

你可以选择提交给 [Rodin Generation](/zh_cn/api-specification/rodin-generation_reset_v.md) 端点的参数，以改变多图像生成的模式。

* fuse 模式将结合所有图像的特征进行生成。
* concat 模式期望这些图像是单个模型的多视图图像。

***

### Capabilities Comparsion

<table data-full-width="true"><thead><tr><th>模式</th><th>描述</th><th>生成时间（预计）</th><th>特点</th><th>HighPack</th></tr></thead><tbody><tr><td>Gen-2</td><td>最先进的3D生成模型</td><td>~90 秒</td><td>可调面数，高质量的纹理（Base Pack提供 2K 纹理）。</td><td>4K 纹理<br>HighPoly(Quad模式)</td></tr><tr><td>Sketch</td><td>快速的，低分辨率的原型 3D 资产生成。</td><td>~20 秒</td><td>基本几何，简单的UV映射，低多边形。</td><td>无</td></tr><tr><td>Regular</td><td>可定制质量的详细3D资产生成。</td><td>~70 秒</td><td>可调面数，高质量的纹理（Base Pack提供 2K 纹理）。</td><td>4K 纹理<br>HighPoly(Quad模式)</td></tr><tr><td>Detail</td><td>比 Regular 更丰富的细节表现，适合复杂需求（生成时间更长）。</td><td>>70 秒</td><td>可调面数，高质量的纹理（Base Pack提供 2K 纹理）。</td><td>4K 纹理<br>HighPoly(Quad模式)</td></tr><tr><td>Smooth</td><td>比 Regular 更清晰锐利的输出效果，生成时间略长。</td><td>>70 秒</td><td>可调面数，高质量的纹理（Base Pack提供 2K 纹理）。</td><td>4K 纹理<br>HighPoly(Quad模式)</td></tr></tbody></table>