# Videozusammenfassung API

> KI-gestützte Videoübersichten, Hashtags und Timeline-Highlights erstellen.

> **Empfehlung: Verwenden Sie die [Video Notes API](https://wayin.ai/de/api-docs/video-notes/)** — gleiche Kosten, mehr Funktionen und Prompt-Steuerung.
>
> _Die bisherige Video Summarization API wird weiterhin vollständig unterstützt._

## Videozusammenfassung API

Senden Sie ein Video beliebiger Länge und erhalten Sie eine KI-generierte strukturierte Übersicht, Hashtags und Timeline-Highlights. Die API unterstützt alles von kurzen Clips bis zu stundenlangen Videos auf allen wichtigen Plattformen und lokal hochgeladene Dateien sowie Spracheinstellungen.

## Unterstützte Videoquellen

YouTube, Vimeo, Dailymotion, Kick, Twitch, TikTok, Facebook, Zoom, Rumble und weitere.

Sie können auch [lokale Videodateien, die Sie hochladen](https://wayin.ai/de/api-docs/upload/), zusammenfassen — der lokale Upload erfordert ein **Starter**-Abonnement oder höher.

### Ablauf

1. **Senden Sie** eine Zusammenfassungsaufgabe mit einer Video-URL
2. **Fragen Sie** die Ergebnisse ab, bis `status` den Wert `SUCCEEDED` hat

---

## Zusammenfassungsaufgabe einreichen

```
POST https://wayinvideo-api.wayin.ai/api/v2/summaries
```

### Anfragekörper

| Parameter     | Typ    | Erforderlich | Standard | Beschreibung                                                                          |
| ------------- | ------ | ------------ | -------- | ------------------------------------------------------------------------------------- |
| `video_url`   | string | Ja           | —        | Quellvideo-URL oder hochgeladene Dateikennung                                         |
| `source_lang` | string | Nein         | `null`   | Quellsprache des Videos. Wenn `null`, wird die Sprache automatisch erkannt.           |
| `target_lang` | string | Nein         | `null`   | Zielsprache für den Ausgabeinhalt. Wenn `null`, entspricht der Ausgabe `source_lang`. |

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/summaries \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{"video_url": "https://www.youtube.com/watch?v=example", "target_lang": "en"}'
```

```python
import requests

requests.post(
    "https://wayinvideo-api.wayin.ai/api/v2/summaries",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "x-wayinvideo-api-version": "v2",
    },
    json={
        "video_url": "https://www.youtube.com/watch?v=example",
        "target_lang": "en",
    },
)
```

```javascript
await fetch('https://wayinvideo-api.wayin.ai/api/v2/summaries', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'x-wayinvideo-api-version': 'v2',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    video_url: 'https://www.youtube.com/watch?v=example',
    target_lang: 'en',
  }),
});
```

### Antwort

```json
{
  "data": {
    "id": "sum_proj_001",
    "name": "sample project name",
    "status": "CREATED"
  }
}
```

---

## Beispiele

Gängige Zusammenfassungsszenarien. Ersetzen Sie `YOUR_API_KEY` durch einen Schlüssel aus dem [API-Dashboard](https://wayin.ai/wayinvideo/api-dashboard).

### Ein YouTube-Video zusammenfassen

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/summaries \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -H "Content-Type: application/json" \
  -d '{"video_url": "https://www.youtube.com/watch?v=EXAMPLE"}'
```

### Eine lange Podcast-Episode zusammenfassen

Mehrstündige Podcasts funktionieren genauso — einreichen und abfragen. Die Antwort enthält Timeline-Highlights, mit denen Sie stundenlanges Audio schnell navigieren können.

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/summaries \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -H "Content-Type: application/json" \
  -d '{"video_url": "https://www.youtube.com/watch?v=EXAMPLE"}'
```

### Ein Webinar in einer anderen Sprache zusammenfassen

Setzen Sie `target_lang`, um die Zusammenfassung, Highlights und Beschreibungen in die Zielsprache zu übersetzen, auch wenn das Quellvideo in einer anderen Sprache ist.

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/summaries \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=EXAMPLE",
    "source_lang": "en",
    "target_lang": "ja"
  }'
```

---

## Zusammenfassungsergebnisse abrufen

```
GET https://wayinvideo-api.wayin.ai/api/v2/summaries/results/{id}
```

```bash
curl -X GET https://wayinvideo-api.wayin.ai/api/v2/summaries/results/sum_proj_001 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2"
```

### Antwort

```json
{
  "data": {
    "status": "SUCCEEDED",
    "title": "sample title",
    "video_thumbnail": "https://cdn.example.com/thumb/video_001.jpg",
    "summary": "sample summary text",
    "tags": ["#topic1", "#topic2"],
    "highlights": [
      {
        "start": 0,
        "end": 196000,
        "desc": "sample section title",
        "events": [{ "timestamp": 160, "desc": "sample event" }]
      }
    ],
    "cost_usage": 54.0
  }
}
```

### Antwortfelder

| Feld              | Typ      | Beschreibung                                          |
| ----------------- | -------- | ----------------------------------------------------- |
| `status`          | string   | `CREATED`, `QUEUED`, `ONGOING`, `SUCCEEDED`, `FAILED` |
| `error_message`   | string   | Fehlerursache (nur wenn `FAILED`)                     |
| `title`           | string   | KI-generierter Titel                                  |
| `video_thumbnail` | string   | Video-Miniaturansicht-URL                             |
| `summary`         | string   | Vollständige Textübersicht                            |
| `tags`            | string[] | KI-generierte Hashtags                                |
| `highlights`      | array    | Timeline-Highlight-Segmente                           |
| `cost_usage`      | number   | Verbrauchte API-Einheiten                             |

### Highlight-Objekt

| Feld     | Typ    | Beschreibung                     |
| -------- | ------ | -------------------------------- |
| `start`  | number | Startzeit in Millisekunden       |
| `end`    | number | Endzeit in Millisekunden         |
| `desc`   | string | Abschnittsbeschreibung           |
| `events` | array  | Schlüsselereignisse im Highlight |

### Ereignis-Objekt

| Feld        | Typ    | Beschreibung                  |
| ----------- | ------ | ----------------------------- |
| `timestamp` | number | Ereigniszeit in Millisekunden |
| `desc`      | string | Ereignisbeschreibung          |

---

## FAQ

### Wie lang darf das Video maximal sein?

Es gibt keine feste Längenbegrenzung. Die API unterstützt sowohl kurze Clips als auch lange Videos, darunter Podcast-Episoden, vollständige Webinare, Vorlesungsaufzeichnungen und Livestream-Replays.

### Was enthält die Zusammenfassungsantwort?

Eine strukturierte Übersicht, Hashtags und eine Timeline von Highlight-Segmenten mit Start-/Endzeitstempeln und Beschreibungen. Highlights erleichtern das Rendern einer Timeline-UI oder das automatische Generieren von Kapitelmarkierungen.

### Kann ich eine Zusammenfassung in einer anderen Sprache als der Quellsprache erhalten?

Ja — übergeben Sie `target_lang`, um die Übersicht, Beschreibungen und Highlights in die Zielsprache zu übersetzen, auch wenn das Quellvideo in einer anderen Sprache ist.

### Welche Videoquellen werden unterstützt?

URLs von YouTube, Vimeo, Dailymotion, Kick, Twitch, TikTok, Facebook, Zoom, Rumble und mehr, plus lokale Datei-Uploads über die [Upload-API](https://wayin.ai/de/api-docs/upload/).