Tripo 系列模型使用指南
平台已接入 Tripo 3D 生成与模型后处理能力。请求参数大体遵循 Tripo 官方中文文档，本指南只说明平台调用方式与官方接口的差异。
1快速开始
所有 Tripo 能力都通过平台异步任务接口提交，随后用 request_id 轮询查询。
POST
/v1/tasks/generations
提交任一 Tripo 任务
提交任务 · 以 H 系列文本生成 3D 为例
curl --request POST \
--url "${BASE_URL}/v1/tasks/generations" \
--header "Authorization: Bearer ${API_KEY}" \
--header "Content-Type: application/json" \
--data '{
"model": "tripo/h",
"prompt": "A low-poly medieval treasure chest",
"texture": true,
"pbr": true
}'
提交成功后，保存响应中的 data.request_id，并用它查询任务：
查询任务 · GET
curl --request GET \
--url "${BASE_URL}/v1/tasks/generations/${REQUEST_ID}" \
--header "Authorization: Bearer ${API_KEY}"
常见任务状态流转如下：
SUBMITTING→
SUBMITTED→
QUEUED→
IN_PROGRESS→
COMPLETED
/
FAILED · CANCELLED
任务完成后：
✓
3D 模型文件 位于
data.data.file_urls✓
预览图或分割遮罩 位于
data.data.image_urls!
data.task_id 是 Tripo 上游任务 ID，仅供记录与排查，不能作为新任务的 input2支持的模型
平台统一使用 /v1/tasks/generations。Tripo 官方通过不同的 request_path（请求路径）区分能力，平台则将它们分别映射为不同的 model。
| 能力 | 平台 model | Tripo 官方 request_path |
|---|---|---|
| H 系列 3D 生成 | tripo/h | /generation/text-to-model · /generation/image-to-model · /generation/multiview-to-model |
| P 系列 3D 生成 | tripo/p | 同上 |
| 贴图 v3.0 | tripo/texture_v3.0 | /models/texture（官方 model=v3.0-20250812） |
| 格式转换 | tripo/convert | /models/convert |
| 图片转 Gaussian Splat | tripo/image-to-splat | /generation/image-to-splat |
| 智能分割 | tripo/smartsegment | /mesh/smartsegment |
| 重拓扑 v2.0 | tripo/decimate_v2.0 | /mesh/decimate（官方 model=v2.0） |
| 重拓扑 v1.0 | tripo/decimate_v1.0 | /mesh/decimate（官方 model=v1.0） |
| 贴图 v2.5 | tripo/texture_v2.5-20250123 | /models/texture（官方 model=v2.5-20250123） |
| 网格分割 v1.0 | tripo/segment_v1.0-20250506 | /mesh/segment（官方 model=v1.0-20250506） |
| 网格分割 v2.0 | tripo/segment_v2.0-20260430 | /mesh/segment（官方 model=v2.0-20260430） |
tripo/h 当前对应 v3.1-20260211，tripo/p 当前对应 P1-20260311。
3生成类型的判断
使用 tripo/h 或 tripo/p 时不需要指定官方请求路径，平台根据请求体自动选择生成类型：
文本 → 3D
prompt
传入文字描述，直接生成 3D 模型
单图 → 3D
input
传入一张图片 URL，生成对应 3D 模型
多视图 → 3D
inputs
传入多张视图图片 URL，生成 3D 模型
⚠ 请只使用其中一种输入形式。字段格式与其他可选参数可直接参考官方文档（见文末参考链接）。
单图生成示例
{
"model": "tripo/h",
"input": "https://example.com/object.png",
"texture": true,
"pbr": true,
"texture_quality": "detailed"
}
4后处理示例
将已完成的 Tripo 任务产物转换为其他格式。
转换为 FBX
{
"model": "tripo/convert",
"input": "https://example.com/model.glb",
"format": "FBX",
"texture_size": 2048,
"texture_format": "PNG"
}
input 应使用可公开访问的模型文件 URL，例如上一个已完成任务查询结果中的 data.data.file_urls[0]。
当前暂不支持将此前 3D 生成任务返回的 task_id 或平台 request_id 作为新任务的 input——请始终传入可公开访问的文件 URL。
5官方文档参考
除上述差异外，请按 Tripo 官方文档传递 snake_case 请求参数，平台会透传。