# 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

1. Chiama `POST /v3/files/presign` con il file `format`.
2. Carica i byte del file su `presigned_url` con HTTP `PUT`.
3. 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`.