http
Base URL: https://openapi.tripo3d.com/v3
Endpoint: POST /files
Upload a file and get a file_token for subsequent API calls.
Note
- This endpoint requires an API Key. Include it in the Authorization header as Bearer {api_key}.
Request Parameters
Request Body
filebinaryRequired
File data. Use
multipart/form-data encoding.Notes
- Images:
JPEG,PNG. Max 20 MB. - Models:
GLB,GLTF,FBX,OBJ,STL. Max 150 MB. - For files larger than 60 MB, consider using File Upload (Large Files) for better performance.
Response
file_tokenstringRequired
File reference token (e.g.,
file_abc123). Use in the input field of other API calls.Examples
Upload
curl -s \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@product-photo.png" \
https://openapi.tripo3d.com/v3/filesUpload
{
"code": 0,
"data": {
"file_token": "file_abc123"}
}