Caricamento file (file di grandi dimensioni)

Crea un caricamento predefinito URL in modo che i file di grandi dimensioni possano essere caricati direttamente nello spazio di archiviazione con HTTP PUT.

Utilizza questo flusso per modelli o immagini 3D di grandi dimensioni quando il caricamento in più parti è meno efficiente. Per i file più piccoli è disponibile anche l’endpoint di caricamento file standard.

Punto finale

HTTP

POST /v3/files/presign

Carica flusso

Chiama POST /v3/files/presign con il file format.
Carica i byte del file su presigned_url con HTTP PUT.
Utilizzare file_token restituito come input nelle chiamate API successive, ad esempio Importa modello, Retopologia, Converti modello o Immagine in modello 3D.

Richiedi corpo

Campo	Digitare	Obbligatorio	Descrizione
`format`	stringa	richiesto	Estensione del file senza punto iniziale, come `glb`, `fbx`, `png` o `webp`.

Campi di risposta

Campo	Digitare	Descrizione
`presigned_url`	stringa	HTTP `PUT` URL temporaneo, valido 30 minuti.
`file_token`	stringa	Token di riferimento del file da utilizzare al termine del caricamento.
`expires_in`	intero	Durata URL in secondi. Fisso a `1800`.

curl Esempio

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

Non aggiungere l’intestazione Tripo Authorization alla richiesta di archiviazione PUT.