# 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 | URL temporaire pour HTTP `PUT`. |
| `file_token` | chaîne | Jeton de référence de fichier à utiliser une fois le téléchargement terminé. |
| `expires_in` | entier | Durée en secondes renvoyée par le service. Elle diffère actuellement de l’expiration de l’URL signée et ne détermine pas la durée de validité exacte de l’URL ou du `file_token`. |
Téléversez le fichier dès réception de l’URL. Après le succès du téléversement, utilisez le `file_token` de la même réponse. Si l’URL expire, redemandez ensemble une URL et un jeton, puis recommencez le téléversement.
## 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`.
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
Appelez POST /v3/files/presign avec le fichier format.
Téléchargez les octets du fichier vers presigned_url avec HTTP PUT.
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
URL temporaire pour HTTP PUT.
file_token
chaîne
Jeton de référence de fichier à utiliser une fois le téléchargement terminé.
expires_in
entier
Durée en secondes renvoyée par le service. Elle diffère actuellement de l’expiration de l’URL signée et ne détermine pas la durée de validité exacte de l’URL ou du file_token.
Téléversez le fichier dès réception de l’URL. Après le succès du téléversement, utilisez le file_token de la même réponse. Si l’URL expire, redemandez ensemble une URL et un jeton, puis recommencez le téléversement.