# 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
1. Llame a `POST /v3/files/presign` con el archivo `format`.
2. Cargue los bytes del archivo en `presigned_url` con HTTP `PUT`.
3. 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 | URL temporal para HTTP `PUT`. |
| `file_token` | cadena | Token de referencia del archivo que se utilizará una vez completada la carga. |
| `expires_in` | entero | Duración en segundos devuelta por el servicio. Actualmente difiere del vencimiento de la URL firmada y no determina la duración exacta de la URL ni del `file_token`. |
Suba el archivo inmediatamente después de obtener la URL. Tras una carga correcta, use el `file_token` de la misma respuesta. Si la URL caduca, solicite juntos una nueva URL y un nuevo token y vuelva a cargar.
## 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`.
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
URL temporal para HTTP PUT.
file_token
cadena
Token de referencia del archivo que se utilizará una vez completada la carga.
expires_in
entero
Duración en segundos devuelta por el servicio. Actualmente difiere del vencimiento de la URL firmada y no determina la duración exacta de la URL ni del file_token.
Suba el archivo inmediatamente después de obtener la URL. Tras una carga correcta, use el file_token de la misma respuesta. Si la URL caduca, solicite juntos una nueva URL y un nuevo token y vuelva a cargar.