# Momente finden API

> Schlüsselmomente in Videos mit natürlichsprachlichen Abfragen identifizieren und extrahieren.

## Momente finden API

Die Momente finden API ermöglicht es Ihnen, die gewünschten Momente in natürlicher Sprache zu beschreiben — wie `"lustige Reaktionen"` oder `"Produktvorstellungen"` — und die API findet und extrahiert passende Clips mit Zeitstempeln, Titeln, Beschreibungen und Hashtags aus Videos jeder Länge.

Sie können Clips aus Momente finden direkt in verbundenen Social-Media-Konten veröffentlichen. Weitere Informationen finden Sie in der [Social Media Publishing API](https://wayin.ai/de/api-docs/social-media-publishing/), um Konten zu verbinden und Veröffentlichungsaufgaben zu erstellen.

## 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/), durchsuchen — der lokale Upload erfordert ein **Starter**-Abonnement oder höher.

---

## Momente-Such-Aufgabe einreichen

```
POST https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments
```

### Anfragekörper

| Parameter | Typ | Erforderlich | Standard | Beschreibung |
|-----------|-----|--------------|----------|--------------|
| `video_url` | string | Ja | — | Quellvideo-URL oder Dateikennung. |
| `query` | string | Ja | `""` | Natürlichsprachliche Abfrage (z.B. `"lustige Reaktionen"`, `"Produktvorstellungen"`) |
| `project_name` | string | Nein | `""` | Benutzerdefinierter Aufgabenname |
| `source_lang` | string | Nein | `null` | Quellsprache. Wenn `null`, automatische Erkennung. |
| `target_lang` | string | Nein | `null` | Zielsprache für Ausgabeinhalt. |
| `limit` | number | Nein | `null` | Maximale Anzahl zurückzugebender Clips. |
| `enable_export` | boolean | Nein | `false` | `false`: nur Metadaten; `true`: sofortiges Rendern. |
| `resolution` | string | Nein | `SD_480` | Auflösung: `SD_480`, `HD_720`, `FHD_1080`, `QHD_2K`, `UHD_4K`. |
| `enable_caption` | boolean | Nein | `false` | Animierte Untertitel hinzufügen. |
| `caption_display` | string | Nein | `original` | Untertitelmodus: `both`, `original`, `translation`. |
| `cc_style_tpl` | string | Nein | `temp-7` | Untertitelstil-Vorlagen-ID. |
| `enable_ai_hook` | boolean | Nein | `false` | KI-generierten Aufmerksamkeitstext hinzufügen. |
| `ai_hook_script_style` | string | Nein | `serious` | Hook-Textstil. |
| `ai_hook_position` | string | Nein | `beginning` | Position: `beginning`, `end`. |
| `enable_ai_reframe` | boolean | Nein | `false` | KI-Reframing aktivieren. |
| `ratio` | string | Erforderlich wenn `enable_ai_reframe` `true` | — | Seitenverhältnis: `RATIO_9_16`, `RATIO_1_1`, `RATIO_4_5`, `RATIO_16_9`. |
| `reframe_layout` | string | Nein | `Auto` | KI-Reframing-Layout. |

<div class="tabs" data-labels="Mit Export|Ohne Export" data-group="export-mode"></div>

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments \
  -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", "query": "sample query", "enable_export": true, "resolution": "FHD_1080"}'
```

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

<div class="tab-divider"></div>

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments \
  -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", "query": "sample query"}'
```

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

<div class="tabs-end"></div>

---

## Beispiele

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

### Lustige Momente in einem YouTube-Video finden

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments \
  -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",
    "query": "funny reactions"
  }'
```

### Produkt-Demo-Segmente aus einem langen Marketing-Video extrahieren

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments \
  -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",
    "query": "product demos and feature walkthroughs",
    "limit": 10
  }'
```

### Sport-Highlights finden und als vertikale Clips mit Untertiteln exportieren

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments \
  -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",
    "query": "goal moments and key plays",
    "enable_export": true,
    "resolution": "FHD_1080",
    "enable_caption": true,
    "enable_ai_reframe": true,
    "ratio": "RATIO_9_16"
  }'
```

---

## Momente-Such-Ergebnisse abrufen

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

> **Inkrementelle Ergebnisse:** Wenn `status` `ONGOING` ist, gibt jeder Aufruf die bisher generierten Clips zurück.

<div class="tabs" data-labels="Mit Export|Ohne Export" data-group="export-mode"></div>

```json
{"data": {"id": "proj_moment_789", "status": "SUCCEEDED", "expire_at": 1775831883112, "cost_usage": 120.0,
          "clips": [{"idx": 0, "title": "sample title", "begin_ms": 120000, "end_ms": 185000,
                     "tags": ["product"], "desc": "sample description", "score": 81,
                     "export_link": "https://cdn.example.com/export/moment_001.mp4"}]}}
```

<div class="tab-divider"></div>

```json
{"data": {"id": "proj_moment_456", "status": "SUCCEEDED", "expire_at": 1775831883112, "cost_usage": 120.0,
          "clips": [{"idx": 0, "title": "sample title", "begin_ms": 120000, "end_ms": 185000,
                     "tags": ["product"], "desc": "sample description", "score": 81}]}}
```

<div class="tabs-end"></div>

Antwortfelder und Clip-Objekt haben dieselbe Struktur wie die [KI-Clipping API](https://wayin.ai/de/api-docs/ai-clipping/#response-fields).

---

## Bestehende Clips erneut exportieren

Verwenden Sie die [Clips-Export-API](https://wayin.ai/de/api-docs/clips-export/) zum späteren Rendern mit anderen Einstellungen.


---

## FAQ

### Wie unterscheidet sich Find Moments von AI Clipping?

[AI Clipping](https://wayin.ai/de/api-docs/ai-clipping/) gibt Clips automatisch nach Viralpotenzial gerankt zurück — ohne Abfrage. **Find Moments** lässt Sie in natürlicher Sprache beschreiben, was Sie möchten (z. B. `"funny reactions"`, `"product demos"`, `"goal moments"`), und gibt nur passende Clips zurück.

### Kann ich die Anzahl der zurückgegebenen Momente begrenzen?

Ja. Übergeben Sie `limit: N`, um nur die nach Relevanz sortierten Top-N-Treffer zurückzugeben. Nützlich, wenn das Quellvideo lang ist und Sie nur die stärksten Treffer möchten.

### Unterstützt Find Moments Teilergebnisse?

Ja — beim Abfragen enthalten Segmente mit `status: ONGOING` bereits die bisher generierten Clips, sodass Sie mit der nachgelagerten Verarbeitung beginnen können, ohne auf den Abschluss der gesamten Aufgabe zu warten.