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