Carga de archivos (archivos grandes)

Cree una carga prefirmada URL para que los archivos grandes se puedan cargar directamente al almacenamiento con HTTP PUT.

Utilice este flujo para modelos o imágenes 3D grandes cuando la carga de varias partes sea menos eficiente. Para archivos más pequeños, el punto final de carga de archivos estándar también está disponible.

Punto final

HTTP

POST /v3/files/presign

Subir flujo

Llame a POST /v3/files/presign con el archivo format.
Cargue los bytes del archivo en presigned_url con HTTP PUT.
Utilice el file_token devuelto como input en llamadas posteriores a API, como Importar modelo, Retopología, Convertir modelo o Imagen a modelo 3D.

Cuerpo de solicitud

campo	Tipo	Requerido	Descripción
`format`	cadena	requerido	Extensión de archivo sin punto inicial, como `glb`, `fbx`, `png` o `webp`.

Campos de respuesta

campo	Tipo	Descripción
`presigned_url`	cadena	Temporal HTTP `PUT` URL, válido por 30 minutos.
`file_token`	cadena	Token de referencia del archivo que se utilizará una vez completada la carga.
`expires_in`	entero	Vida útil de URL en segundos. Fijado en `1800`.

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

No agregue el encabezado Tripo Authorization a la solicitud de almacenamiento PUT.