# 파일 업로드(대용량 파일)
HTTP `PUT`를 사용하여 대용량 파일을 스토리지에 직접 업로드할 수 있도록 미리 서명된 업로드 URL를 만듭니다.
멀티파트 업로드가 덜 효율적인 경우 대형 3D 모델이나 이미지에 이 흐름을 사용하세요. 더 작은 파일의 경우 표준 파일 업로드 엔드포인트도 사용할 수 있습니다.
## 엔드포인트
```http
POST /v3/files/presign
```
## 업로드 흐름
1. `format` 파일을 사용하여 `POST /v3/files/presign`를 호출합니다.
2. HTTP `PUT`를 사용하여 파일 바이트를 `presigned_url`에 업로드합니다.
3. 모델 가져오기, 리토폴로지, 모델 변환 또는 이미지를 3D 모델로 변환과 같은 이후 API 호출에서 반환된 `file_token`를 `input`로 사용합니다.
## 요청 본문
| 필드 | 유형 | 필수 | 설명 |
| --- | --- | --- | --- |
| `format` | 문자열 | 필수 | `glb`, `fbx`, `png` 또는 `webp`와 같이 앞에 점이 없는 파일 확장자입니다. |
## 응답 필드
| 필드 | 유형 | 설명 |
| --- | --- | --- |
| `presigned_url` | 문자열 | 임시 HTTP `PUT` URL, 30분간 유효합니다. |
| `file_token` | 문자열 | 업로드가 완료된 후 사용할 파일 참조 토큰입니다. |
| `expires_in` | 정수 | URL 수명(초)입니다. `1800`으로 고정됩니다. |
## curl 예
```bash
curl -s -X POST https://openapi.tripo3d.ai/v3/files/presign \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"format":"glb"}'
curl -X PUT \
-H "Content-Type: application/octet-stream" \
-T model.glb \
"<presigned_url>"
```
스토리지 `PUT` 요청에 Tripo `Authorization` 헤더를 추가하지 마세요.
파일 업로드(대용량 파일)
HTTP PUT를 사용하여 대용량 파일을 스토리지에 직접 업로드할 수 있도록 미리 서명된 업로드 URL를 만듭니다.
멀티파트 업로드가 덜 효율적인 경우 대형 3D 모델이나 이미지에 이 흐름을 사용하세요. 더 작은 파일의 경우 표준 파일 업로드 엔드포인트도 사용할 수 있습니다.
엔드포인트
업로드 흐름
format 파일을 사용하여 POST /v3/files/presign를 호출합니다.- HTTP
PUT를 사용하여 파일 바이트를 presigned_url에 업로드합니다.
- 모델 가져오기, 리토폴로지, 모델 변환 또는 이미지를 3D 모델로 변환과 같은 이후 API 호출에서 반환된
file_token를 input로 사용합니다.
요청 본문
| 필드 |
유형 |
필수 |
설명 |
format |
문자열 |
필수 |
glb, fbx, png 또는 webp와 같이 앞에 점이 없는 파일 확장자입니다. |
응답 필드
| 필드 |
유형 |
설명 |
presigned_url |
문자열 |
임시 HTTP PUT URL, 30분간 유효합니다. |
file_token |
문자열 |
업로드가 완료된 후 사용할 파일 참조 토큰입니다. |
expires_in |
정수 |
URL 수명(초)입니다. 1800으로 고정됩니다. |
curl 예
curl -s -X POST https://openapi.tripo3d.ai/v3/files/presign \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"format":"glb"}'
curl -X PUT \
-H "Content-Type: application/octet-stream" \
-T model.glb \
"<presigned_url>"
스토리지 PUT 요청에 Tripo Authorization 헤더를 추가하지 마세요.
