Datei-Upload (große Dateien)

Erstellen Sie einen vorsignierten Upload URL, damit große Dateien mit HTTP PUT direkt in den Speicher hochgeladen werden können.

Verwenden Sie diesen Ablauf für große 3D-Modelle oder Bilder, wenn der mehrteilige Upload weniger effizient ist. Für kleinere Dateien ist auch der Standard-Datei-Upload-Endpunkt verfügbar.

Endpunkt

HTTP

POST /v3/files/presign

Ablauf hochladen

Rufen Sie POST /v3/files/presign mit der Datei format auf.
Laden Sie die Dateibytes mit HTTP PUT nach presigned_url hoch.
Verwenden Sie das zurückgegebene file_token als input in späteren API-Aufrufen, z. B. „Modell importieren“, „Retopologie“, „Modell konvertieren“ oder „Bild in 3D-Modell“.

Anforderungstext

Feld	Typ	Erforderlich	Beschreibung
`format`	Zeichenfolge	erforderlich	Dateierweiterung ohne führenden Punkt, z. B. `glb`, `fbx`, `png` oder `webp`.

Antwortfelder

Feld	Typ	Beschreibung
`presigned_url`	Zeichenfolge	Temporär HTTP `PUT` URL, gültig für 30 Minuten.
`file_token`	Zeichenfolge	Dateireferenztoken, das nach Abschluss des Uploads verwendet werden soll.
`expires_in`	ganze Zahl	URL Lebensdauer in Sekunden. Festgelegt auf `1800`.

curl Beispiel

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

Fügen Sie den Header Tripo Authorization nicht zur Speicheranforderung PUT hinzu.