# 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 | HTTP `PUT` için geçici URL. |
| `file_token` | dize | Yükleme tamamlandıktan sonra kullanılacak dosya referans jetonu. |
| `expires_in` | tamsayı | Hizmetin saniye cinsinden döndürdüğü süredir. Şu anda imzalı URL süresiyle farklıdır; URL veya `file_token` için kesin geçerlilik süresini belirlemez. |
URL alındıktan hemen sonra dosyayı yükleyin. Yükleme başarılı olunca aynı yanıttaki `file_token` değerini kullanın. URL süresi dolarsa yeni URL ile token değerini birlikte alın ve yeniden yükleyin.
## 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.
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
format dosyasıyla POST /v3/files/presign’yi arayın.
Dosya baytlarını HTTP PUT ile presigned_url’ye yükleyin.
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
HTTP PUT için geçici URL.
file_token
dize
Yükleme tamamlandıktan sonra kullanılacak dosya referans jetonu.
expires_in
tamsayı
Hizmetin saniye cinsinden döndürdüğü süredir. Şu anda imzalı URL süresiyle farklıdır; URL veya file_token için kesin geçerlilik süresini belirlemez.
URL alındıktan hemen sonra dosyayı yükleyin. Yükleme başarılı olunca aynı yanıttaki file_token değerini kullanın. URL süresi dolarsa yeni URL ile token değerini birlikte alın ve yeniden yükleyin.