> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vibetoken.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Tripo H3.1 API

> Tripo H3.1 快速入门 —— 高精度文生 3D 与图生 3D，带 PBR 材质，可选 8K 贴图、超精细几何、四边面、智能低模与部件拆分。

## 概述

**Tripo H3.1** 是 Tripo 最新的高精度 3D 模型。它可以把一段文本提示词或一张参考图转换为细节丰富、带 PBR 材质的网格模型，并可选 HD 或 8K 贴图、超精细几何、四边面网格、智能低模拓扑和部件拆分。适合对表面细节和贴图质量要求最高的场景：游戏与影视的主角资产、产品展示，以及之后需要拆分部件或重新拓扑的模型。

| | |
| - | - |
| **服务商** | Tripo（官方 API） |
| **系列** | `tripo-h3.1` |
| **模型版本** | `v3.1-20260211` |
| **模态** | 3D |
| **支持的任务** | `text-to-3d`、`image-to-3d` |
| **输出** | GLB 模型（`quad: true` 时为 FBX）+ PNG 预览图 |
| **面数** | 500 到 2,000,000（`face_limit`） |
| **典型生成耗时** | 1–3 分钟 |

需要更轻量的网格？[Tripo P1](https://docs.vibetoken.cn/zh/tripo-p1-api/quickstart.md) 生成拓扑干净的低模，[Tripo P2](https://docs.vibetoken.cn/zh/tripo-p2-api/quickstart.md) 生成原生四边面拓扑的游戏级低模。

## 端点

```http theme={null}
POST https://vibetoken.cn/v1/3d/generations
```

这是一个**异步**端点。POST 会立即返回 `{id, status: "pending"}`；
轮询 `GET /v1/3d/generations/{id}` 直到 `status` 为 `success`
（附 `data: [{url}, {url}]`：先是模型文件，然后是预览图）或 `failed`。
完整的请求与响应对象、幂等性和回调见 [3D 生成参考](https://docs.vibetoken.cn/zh/api-reference/3d.md)。

## 支持的任务

* [`text-to-3d`](https://docs.vibetoken.cn/zh/tripo-h3-1-api/text-to-3d) — `tripo/h3.1-text-to-3d`
* [`image-to-3d`](https://docs.vibetoken.cn/zh/tripo-h3-1-api/image-to-3d) — `tripo/h3.1-image-to-3d`

## 选项

| 选项 | 开启方式 |
| - | - |
| 无贴图白模 | `texture: false` 且 `pbr: false` |
| HD 贴图 | `texture_quality: "detailed"` |
| 8K 贴图 | `texture_quality: "extreme"` |
| 超精细几何 | `geometry_quality: "detailed"` |
| 四边面网格（FBX 输出） | `quad: true` |
| 智能低模拓扑 | `smart_low_poly: true` |
| 拆分为可编辑部件 | `generate_parts: true`，并设置 `texture: false` 与 `pbr: false` |
| 按真实尺寸缩放（米） | `auto_size: true` |
| 面数预算 | `face_limit`，500 到 2,000,000 |

未传入的选项均取默认值：标准质量、带 PBR 材质的有贴图模型。

## 输出

`success` 时，`data` 按固定顺序包含生成的文件：

* `data[0].url` —— 3D 模型：内嵌材质的二进制 glTF（`.glb`）文件；`quad: true` 时为 `.fbx`。
* `data[1].url` —— 模型的 PNG 渲染预览图（Tripo 返回时提供）。

两个文件都托管在 VibeToken 媒体 CDN 上，每个 URL 都以文件的真实扩展名结尾，可据此选择
加载器。需要长期保留的文件请自行下载保存。

## 定价

按次计费。价格取决于任务类型（文本或图片输入）、是否生成贴图，以及你开启的附加选项（HD 或 8K 贴图、超精细几何、四边面网格、智能低模、部件拆分）。
提交时会按你发送的选项预留相应金额；成功后按该次生成的实际消耗扣费，且不会超过预留金额。
失败的生成不收费，预留金额会被释放。当前费率请见[定价页](https://vibetoken.cn/pricing)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.