http
Base URL: https://openapi.tripo3d.ai/v3
Endpoint: POST /models/import
将外部 3D 模型文件导入 Tripo 平台以进行后续处理。
请求参数
请求体
inputstring必选
模型文件来源。接受
file_token(前缀 file_)或 URL。说明
- 支持格式:
GLB、GLTF、FBX、OBJ、STL - 最大文件大小:150 MB
返回参数
model_urlstring必选
导入后的模型下载地址。
rendered_image_urlstring
渲染预览图地址。
normalize_scalenumber
导入模型归一化时应用的等比缩放系数:
导入模型任务,以及模型输入为
归一化后尺寸 = 归一化前尺寸 × normalize_scale。1.0 表示未缩放,但仍可能发生平移。将归一化后的尺寸除以该系数,可恢复归一化前的尺寸;平台输出保留归一化结果。导入模型任务,以及模型输入为
file_token 或 URL 的模型后处理任务(绑骨、贴图、格式转换等,会先导入模型)返回该字段;输入为 task_id 的任务,以及该字段上线前创建的任务不返回。normalize_translationnumber[]
导入模型归一化时应用的平移向量,格式为
[tx, ty, tz],包含 3 个数值。与 normalize_scale 配合使用:归一化后坐标 = 归一化前坐标 × normalize_scale + normalize_translation 归一化前坐标 = (归一化后坐标 - normalize_translation) / normalize_scale仅在导入流程提供该值时返回,返回该字段的任务与
normalize_scale 相同;输入为 task_id 的任务,以及该字段上线前创建的任务不返回。示例
文件示例
{
"input": "file_abc123"}URL 示例
{
"input": "https://example.com/my-model.glb"}创建任务
{
"code": 0,
"data": {
"task_id": "123e4567-e89b-42d3-a456-426614174000"}
}任务结果
{
"code": 0,
"data": {
"task_id": "123e4567-e89b-42d3-a456-426614174000",
"type": "import_model",
"status": "success",
"progress": 100,
"output": {
"model_url": "https://cdn.tripo3d.ai/output/tripo_input.glb",
"rendered_image_url": "https://cdn.tripo3d.ai/output/preview.webp",
"normalize_scale": 0.365714,
"normalize_translation": [
-1,
-0.5,
-1.5
]
},
"created_at": "2026-04-28T12:00:00Z",
"completed_at": "2026-04-28T12:00:02Z"}
}