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.

Lokale Uploads erfordern einen Standard-Plan oder höher. Weitere Details in der Upload-API.

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

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.