Find Moments API – Lange Videos per natürlicher Sprache durchsuchen

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.

Unterstützte Videoquellen

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

Sie können auch lokale Videodateien, die Sie hochladen, durchsuchen — der lokale Upload erfordert einen Standard-Plan 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.

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"}'

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

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"}'

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

Beispiele

Gängige Find-Moments-Szenarien. Ersetzen Sie YOUR_API_KEY durch einen Schlüssel aus dem API-Dashboard.

Lustige Momente in einem YouTube-Video finden

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

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

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.

{"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"}]}}

{"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}]}}

Antwortfelder und Clip-Objekt haben dieselbe Struktur wie die KI-Clipping API.

Bestehende Clips erneut exportieren

Verwenden Sie die Clips-Export-API zum späteren Rendern mit anderen Einstellungen.

FAQ

Wie unterscheidet sich Find Moments von AI Clipping?

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.