Загрузка файлов (большие файлы)

Создайте заранее подготовленную загрузку URL, чтобы большие файлы можно было загружать непосредственно в хранилище с помощью HTTP PUT.

Используйте этот процесс для больших 3D-моделей или изображений, когда загрузка нескольких частей менее эффективна. Для файлов меньшего размера также доступна стандартная конечная точка загрузки файлов.

Конечная точка

HTTP

POST /v3/files/presign

Процесс загрузки

Вызовите POST /v3/files/presign с помощью файла format.
Загрузите байты файла в presigned_url с помощью HTTP PUT.
Используйте возвращенный file_token как input в последующих вызовах API, таких как импорт модели, ретопология, преобразование модели или изображение в 3D-модель.

Тело запроса

Поле	Тип	Требуется	Описание
`format`	строка	требуется	Расширение файла без начальной точки, например `glb`, `fbx`, `png` или `webp`.

Поля ответа

Поле	Тип	Описание
`presigned_url`	строка	Временный HTTP `PUT` URL, действителен в течение 30 минут.
`file_token`	строка	Токен ссылки на файл, который будет использоваться после завершения загрузки.
`expires_in`	целое число	Время жизни URL в секундах. Фиксированное значение `1800`.

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

Не добавляйте заголовок Tripo Authorization к запросу хранилища PUT.