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

> Tripo P1 快速入门 —— 由文本提示词或单张图片生成拓扑干净的低模 3D 模型（50 到 20,000 面）。

## 概述

**Tripo P1** 是 Tripo 的低模模型。它生成拓扑干净、面数 50 到 20,000 的轻量网格，可直接用于对多边形预算要求严格的游戏引擎、UGC 平台和移动应用。

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

需要更多？[Tripo P2](https://docs.vibetoken.cn/zh/tripo-p2-api/quickstart.md) 是支持四边面拓扑、面数更高的游戏级低模档位，[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-p1-api/text-to-3d) — `tripo/p1-text-to-3d`
* [`image-to-3d`](https://docs.vibetoken.cn/zh/tripo-p1-api/image-to-3d) — `tripo/p1-image-to-3d`

## 选项

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

P1 不提供 `quad`、`geometry_quality`、`smart_low_poly` 和 `generate_parts`：需要四边面输出请使用 [Tripo P2](https://docs.vibetoken.cn/zh/tripo-p2-api/quickstart.md)，其余选项请使用 [Tripo H3.1](https://docs.vibetoken.cn/zh/tripo-h3-1-api/quickstart.md)。

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

## 输出

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

* `data[0].url` —— 3D 模型：内嵌材质的二进制 glTF（`.glb`）文件。
* `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.