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	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.