# 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äre URL für HTTP `PUT`. |
| `file_token` | Zeichenfolge | Dateireferenztoken, das nach Abschluss des Uploads verwendet werden soll. |
| `expires_in` | ganze Zahl | Vom Dienst zurückgegebene Dauer in Sekunden. Sie weicht derzeit vom Ablauf der signierten URL ab und bestimmt nicht die genaue Gültigkeitsdauer der URL oder des `file_token`. |
Laden Sie die Datei unmittelbar nach Erhalt der URL hoch. Verwenden Sie nach erfolgreichem Upload den `file_token` aus derselben Antwort. Ist die URL abgelaufen, fordern Sie URL und Token gemeinsam neu an und laden Sie erneut hoch.
## 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.
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
Rufen Sie POST /v3/files/presign mit der Datei format auf.
Laden Sie die Dateibytes mit HTTP PUT nach presigned_url hoch.
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äre URL für HTTP PUT.
file_token
Zeichenfolge
Dateireferenztoken, das nach Abschluss des Uploads verwendet werden soll.
expires_in
ganze Zahl
Vom Dienst zurückgegebene Dauer in Sekunden. Sie weicht derzeit vom Ablauf der signierten URL ab und bestimmt nicht die genaue Gültigkeitsdauer der URL oder des file_token.
Laden Sie die Datei unmittelbar nach Erhalt der URL hoch. Verwenden Sie nach erfolgreichem Upload den file_token aus derselben Antwort. Ist die URL abgelaufen, fordern Sie URL und Token gemeinsam neu an und laden Sie erneut hoch.