# 文件管理
**Base URL:** `https://openapi.tripo3d.ai/v3`
**Endpoint:** `POST /files`
上传文件并获取 file_token 以供后续 API 调用使用。
## Request Parameters
### file
- **Type:** binary
- **Required:** 必选
文件数据。使用 `multipart/form-data` 编码。
- 图片：`JPEG`、`PNG`。最大 **20 MB**。
- 模型：`GLB`、`GLTF`、`FBX`、`OBJ`、`STL`。最大 **150 MB**。
- 建议 > 60MB 的文件，可以参考文件上传(大文件)，有更快的性能体验。
## Response Fields
### file_token
- **Type:** string
- **Required:** 必选
文件引用 token（如 `file_abc123`）。在其他 API 调用的 `input` 字段中使用。
## Request Example
### 上传示例
```
curl -s \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@product-photo.png" \
https://openapi.tripo3d.com/v3/files
```
## Response Example
### 上传示例
```json
{
"code": 0,
"data": {
"file_token": "file_abc123"
}
}
```
请求参数
请求体
filebinary必选
文件数据。使用 multipart/form-data 编码。
- 图片：
JPEG、PNG。最大 20 MB。 - 模型：
GLB、GLTF、FBX、OBJ、STL。最大 150 MB。 - 建议 > 60MB 的文件，可以参考文件上传(大文件)，有更快的性能体验。
返回参数
file_tokenstring必选
文件引用 token（如 file_abc123）。在其他 API 调用的 input 字段中使用。
示例
curl -s \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@product-photo.png" \
https://openapi.tripo3d.com/v3/files
{
"code": 0,
"data": {
"file_token": "file_abc123"}
}
