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

> Tripo P2 快速入门 —— 面向游戏的低模 3D 模型，原生四边面拓扑，最多 50,000 个三角面或 25,000 个四边面。

## 概述

**Tripo P2** 是 Tripo 面向游戏的低模模型，支持原生四边面拓扑。网格最多 50,000 个三角面，开启 `quad: true` 时最多 25,000 个四边面，适合直接导入游戏引擎、或在建模软件中继续编辑的资产。

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

需要其他取舍？[Tripo P1](https://docs.vibetoken.cn/zh/tripo-p1-api/quickstart.md) 更轻量（50 到 20,000 面），[Tripo H3.1](https://docs.vibetoken.cn/zh/tripo-h3-1-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-p2-api/text-to-3d) — `tripo/p2-text-to-3d`
* [`image-to-3d`](https://docs.vibetoken.cn/zh/tripo-p2-api/image-to-3d) — `tripo/p2-image-to-3d`

## 选项

| 选项 | 开启方式 |
| - | - |
| 无贴图白模 | `texture: false` 且 `pbr: false` |
| HD 贴图 | `texture_quality: "detailed"` |
| 8K 贴图 | `texture_quality: "extreme"` |
| 四边面网格（FBX 输出） | `quad: true` |
| 按真实尺寸缩放（米） | `auto_size: true` |
| 面数预算 | `face_limit`，48 到 50,000 |

P2 不提供 `geometry_quality`、`smart_low_poly` 和 `generate_parts`，这些是 [Tripo H3.1](https://docs.vibetoken.cn/zh/tripo-h3-1-api/quickstart.md) 的选项。

未传入的选项均取默认值：标准质量、带 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.