# Téléchargement de fichiers (fichiers volumineux)

Créez un téléchargement prédéfini URL afin que les fichiers volumineux puissent être téléchargés directement vers le stockage avec HTTP `PUT`.

Utilisez ce flux pour les grands modèles ou images 3D lorsque le téléchargement en plusieurs parties est moins efficace. Pour les fichiers plus petits, le point de terminaison standard de téléchargement de fichiers est également disponible.

## Point de terminaison

```http
POST /v3/files/presign
```

## Flux de téléchargement

1. Appelez `POST /v3/files/presign` avec le fichier `format`.
2. Téléchargez les octets du fichier vers `presigned_url` avec HTTP `PUT`.
3. Utilisez le `file_token` renvoyé comme `input` dans les appels API ultérieurs, tels que Importer un modèle, Retopologie, Convertir un modèle ou Image en modèle 3D.

## Corps de la demande

| Champ | Tapez | Obligatoire | Descriptif |
| --- | --- | --- | --- |
| `format` | chaîne | requis | Extension de fichier sans point initial, telle que `glb`, `fbx`, `png` ou `webp`. |

## Champs de réponse

| Champ | Tapez | Descriptif |
| --- | --- | --- |
| `presigned_url` | chaîne | Temporaire HTTP `PUT` URL, valable 30 minutes. |
| `file_token` | chaîne | Jeton de référence de fichier à utiliser une fois le téléchargement terminé. |
| `expires_in` | entier | Durée de vie URL en secondes. Fixé à `1800`. |

## Exemple curl

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

N'ajoutez pas l'en-tête Tripo `Authorization` à la demande de stockage `PUT`.