# Datei-Upload (große Dateien)

Erstellen Sie einen vorsignierten Upload URL, damit große Dateien mit HTTP `PUT` direkt in den Speicher hochgeladen werden können.

Verwenden Sie diesen Ablauf für große 3D-Modelle oder Bilder, wenn der mehrteilige Upload weniger effizient ist. Für kleinere Dateien ist auch der Standard-Datei-Upload-Endpunkt verfügbar.

## Endpunkt

```http
POST /v3/files/presign
```

## Ablauf hochladen

1. Rufen Sie `POST /v3/files/presign` mit der Datei `format` auf.
2. Laden Sie die Dateibytes mit HTTP `PUT` nach `presigned_url` hoch.
3. Verwenden Sie das zurückgegebene `file_token` als `input` in späteren API-Aufrufen, z. B. „Modell importieren“, „Retopologie“, „Modell konvertieren“ oder „Bild in 3D-Modell“.

## Anforderungstext

| Feld | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| `format` | Zeichenfolge | erforderlich | Dateierweiterung ohne führenden Punkt, z. B. `glb`, `fbx`, `png` oder `webp`. |

## Antwortfelder

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `presigned_url` | Zeichenfolge | Temporär HTTP `PUT` URL, gültig für 30 Minuten. |
| `file_token` | Zeichenfolge | Dateireferenztoken, das nach Abschluss des Uploads verwendet werden soll. |
| `expires_in` | ganze Zahl | URL Lebensdauer in Sekunden. Festgelegt auf `1800`. |

## curl Beispiel

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

Fügen Sie den Header Tripo `Authorization` nicht zur Speicheranforderung `PUT` hinzu.