# Upload-API

> Lokale Videodateien für AI Clipping, Summarization, Video Notes, Transcription, Find Moments und Video Enhancer hochladen.

## Upload-API

Die Upload-API ermöglicht es Ihnen, lokale Videodateien zu WayinVideo hochzuladen. Nach dem Hochladen verwenden Sie die zurückgegebene Dateikennung als `video_url` in anderen API-Endpunkten (KI-Clipping, Momente finden, Videozusammenfassung, Video Notes, Videotranskription, Video-Enhancer).

**Dateigrößenlimit:** Das Limit für einzelne lokale Uploads beträgt 5 GB. Wenn Sie ein höheres Limit benötigen, kontaktieren Sie uns unter [wayinvideo@wayin.ai](mailto:wayinvideo@wayin.ai).

**Unterstützte Formate:** Sie müssen eine gültige Videodatei hochladen. Derzeit unterstützte Formate: **avi**, **mp4**, **mov**, **webm**. Das Hochladen anderer Formate kann nach dem Einreichen zu Verarbeitungsfehlern führen.

### Upload-Ablauf

1. **Anfragen**: Upload-URL mit Datei-Metadaten anfordern
2. **Hochladen**: Datei direkt an die vorab signierte URL per `PUT`-Anfrage senden
3. **Verwenden**: Zurückgegebenen `identity`-Wert als `video_url` in nachfolgenden API-Aufrufen verwenden

---

## Upload-URL abrufen

```
POST https://wayinvideo-api.wayin.ai/api/v2/upload/single-file
```

### Anfragekörper

| Parameter | Typ    | Erforderlich | Beschreibung                                      |
| --------- | ------ | ------------ | ------------------------------------------------- |
| `name`    | string | Ja           | Dateiname mit Erweiterung (z.B. `"my-video.mp4"`) |

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/upload/single-file \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{"name": "sample-video.mp4"}'
```

### Antwort

```json
{
  "data": {
    "upload_url": "https://storage.example.com/upload/presigned-url...",
    "identity": "file_abc123"
  }
}
```

| Feld         | Typ    | Beschreibung                                                    |
| ------------ | ------ | --------------------------------------------------------------- |
| `upload_url` | string | Vorab signierte URL für den Upload. Läuft nach **1 Stunde** ab. |
| `identity`   | string | Dateikennung zur Verwendung als `video_url` in anderen APIs     |

---

## Datei hochladen

```bash
curl -X PUT "https://storage.example.com/upload/presigned-url..." \
  -H "Content-Type: video/mp4" \
  --data-binary @/Users/me/Videos/sample-video.mp4
```

---

## Hochgeladene Datei verwenden

> Jede `identity` ist **24 Stunden** gültig.

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{"video_url": "THE_IDENTITY_VALUE", "enable_export": false}'
```

---

## FAQ

### Wann sollte ich eine lokale Datei hochladen vs. eine Quell-URL übergeben?

Wenn Ihr Video bereits auf einer unterstützten Plattform (YouTube, Vimeo, TikTok, Zoom usw.) existiert, übergeben Sie die URL direkt an den Verarbeitungs-Endpunkt — kein Upload erforderlich. Verwenden Sie die Upload-API nur für Dateien, die noch nicht auf einer unterstützten Quelle gehostet werden.

### Wie groß darf eine hochgeladene Datei maximal sein?

5 GB pro Datei. Kontaktieren Sie [wayinvideo@wayin.ai](mailto:wayinvideo@wayin.ai), falls Ihr Anwendungsfall ein höheres Limit benötigt.

### Welche Dateiformate werden unterstützt?

`mp4`, `mov`, `webm`, `avi`. Andere Formate können bei der Verarbeitung fehlschlagen.

### Wird der Upload auf mein Plan-Speicherkontingent angerechnet?

Ja — hochgeladene Dateien verbrauchen Speicher in Ihrem Abonnementplan. Siehe [Abonnementpläne](https://wayin.ai/wayinvideo/settings/plan) für Speicher- und Dateigrößenbeschränkungen pro Plan.

### Wie verwende ich die hochgeladene Datei in anderen API-Aufrufen?

Übergeben Sie nach dem Upload die zurückgegebene Dateikennung als `video_url`-Feld an einen unterstützten Verarbeitungs-Endpunkt — [AI Clipping](https://wayin.ai/de/api-docs/ai-clipping/), [Find Moments](https://wayin.ai/de/api-docs/find-moments/), [Video Summarization](https://wayin.ai/de/api-docs/video-summarization/), [Video Notes](https://wayin.ai/de/api-docs/video-notes/), [Video Transcription](https://wayin.ai/de/api-docs/video-transcription/) oder [Video Enhancer](https://wayin.ai/de/api-docs/video-enhancer/).