# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.hyper3d.ai/zh_cn/api-specification/overview_reset_v.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
