# Dosya Yükleme (Büyük Dosyalar)

HTTP `PUT` ile büyük dosyaların doğrudan depolamaya yüklenebilmesi için önceden imzalanmış bir yükleme URL oluşturun.

Çok parçalı yüklemenin daha az verimli olduğu durumlarda büyük 3D modeller veya görüntüler için bu akışı kullanın. Daha küçük dosyalar için standart Dosya Yükleme uç noktası da mevcuttur.

## Uç nokta

```http
POST /v3/files/presign
```

## Akışı Yükle

1. `format` dosyasıyla `POST /v3/files/presign`'yi arayın.
2. Dosya baytlarını HTTP `PUT` ile `presigned_url`'ye yükleyin.
3. Döndürülen `file_token`'yi, Modeli İçe Aktarma, Retopoloji, Modeli Dönüştürme veya Görüntüyü 3B Modele Dönüştürme gibi daha sonraki API çağrılarında `input` olarak kullanın.

## Talep Gövdesi

| Alan | Tür | Gerekli | Açıklama |
| --- | --- | --- | --- |
| `format` | dize | gerekli | `glb`, `fbx`, `png` veya `webp` gibi başta noktası olmayan dosya uzantısı. |

## Yanıt Alanları

| Alan | Tür | Açıklama |
| --- | --- | --- |
| `presigned_url` | dize | Geçici HTTP `PUT` URL, 30 dakika süreyle geçerlidir. |
| `file_token` | dize | Yükleme tamamlandıktan sonra kullanılacak dosya referans jetonu. |
| `expires_in` | tamsayı | URL saniye cinsinden kullanım ömrü. `1800` olarak sabittir. |

## curl Örnek

```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>"
```

Tripo `Authorization` üstbilgisini depolama `PUT` isteğine eklemeyin.