KI-Clipping API

April 1, 2026

KI-Clipping API

Senden Sie ein Video beliebiger Länge und erhalten Sie alle nach Viralpotenzial geordneten Clips. Jeder Clip enthält automatisch erkannte Start-/Endzeiten, KI-generierte Titel, Beschreibungen und Hashtags. Optional werden gerenderte Clip-Videos mit KI-Reframing und animierten Untertiteln exportiert.

Sie können Clips aus KI-Clipping direkt in verbundenen Social-Media-Konten veröffentlichen. Weitere Informationen finden Sie in der Social Media Publishing API, 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, clippen — der lokale Upload erfordert ein Standard-Abonnement oder höher.


Clipping-Aufgabe einreichen

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

Anfragekörper

ParameterTypErforderlichStandardBeschreibung
video_urlstringJaQuellvideo-URL oder Dateikennung von der Upload-API.
project_namestringNein""Benutzerdefinierter Aufgabenname
source_langstringNeinnullQuellsprache des Videos. Wenn null, automatische Erkennung.
target_langstringNeinnullZielsprache für Titel, Beschreibungen und Untertitel.
target_durationstringNeinDURATION_0_90Erwartete Clip-Dauer: DURATION_0_30, DURATION_0_90, DURATION_30_60, DURATION_60_90, DURATION_90_180, DURATION_180_300.
limitnumberNeinnullMaximale Anzahl zurückzugebender Clips.
enable_exportbooleanNeinfalsefalse: nur Metadaten; true: sofortiges Rendern mit Download-Link.
resolutionstringNeinSD_480Auflösung: SD_480, HD_720, FHD_1080, QHD_2K, UHD_4K.
enable_captionbooleanNeinfalseAnimierte Untertitel beim Rendern hinzufügen.
caption_displaystringNeinoriginalUntertitelmodus: both, original, translation.
cc_style_tplstringNeintemp-7Untertitelstil-Vorlagen-ID (siehe Untertitelstile).
enable_ai_hookbooleanNeinfalseKI-generierten Aufmerksamkeitstext am Anfang oder Ende hinzufügen.
ai_hook_script_stylestringNeinseriousHook-Textstil: serious, casual, informative, conversational, humorous, parody, inspirational, dramatic, empathetic, persuasive, neutral, excited, calm.
ai_hook_positionstringNeinbeginningPosition: beginning, end.
enable_ai_reframebooleanNeinfalseKI-Reframing aktivieren. Wenn true, ist ratio erforderlich.
ratiostringErforderlich wenn enable_ai_reframe trueSeitenverhältnis: RATIO_9_16, RATIO_1_1, RATIO_4_5, RATIO_16_9.
reframe_layoutstringNeinAutoKI-Reframing-Layout. Siehe den Abschnitt Layout-Werte.
enable_more_resultsbooleanNeinfalseMehr Clips generieren. Nur mit Enterprise-Abonnement.
enable_express_modebooleanNeinfalseExpress-Modus: halber API-Einheitenverbrauch. Nur mit Enterprise-Abonnement.

Reframing-Layout-Werte

ratioErlaubte reframe_layout-Werte
RATIO_16_9Auto, Full, Fit, Grid 4, Split 2, Trio, PiP, OTS, Screen First
RATIO_9_16Auto, Full, Fit, Grid 4, Split 2, Trio, PiP, Screen First, Gameplay A, Gameplay B
RATIO_1_1Auto, Full, Fit, Grid 4, Trio
RATIO_4_5Auto, Full, Fit, Grid 4, Split 2, Trio, PiP, Screen First, Gameplay A, Gameplay B

enable_export auf true gesetzt. Clips werden gerendert, jeder enthält export_link.

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": "https://www.youtube.com/watch?v=example", "target_duration": "DURATION_30_60", "enable_export": true, "resolution": "HD_720", "enable_caption": true, "enable_ai_reframe": true, "ratio": "RATIO_9_16"}'
{"data": {"id": "proj_xyz789", "name": "sample project name", "status": "CREATED"}}

enable_export weggelassen oder false. Nur Metadaten, kein Rendering.

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": "https://www.youtube.com/watch?v=example", "target_duration": "DURATION_30_60"}'
{"data": {"id": "proj_abc123", "name": "sample project name", "status": "CREATED"}}

Beispiele

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

Ein YouTube-Video in virale Clips schneiden

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
  -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 Webinar-Aufzeichnung in vertikale 9:16-Shorts mit Untertiteln schneiden

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
  -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",
    "target_duration": "DURATION_30_60",
    "enable_export": true,
    "resolution": "HD_720",
    "enable_caption": true,
    "enable_ai_reframe": true,
    "ratio": "RATIO_9_16"
  }'

Einen Podcast in die bestplatzierten Shorts schneiden

Nützlich für langformatige Inhalte, bei denen Sie nur die Clips mit den höchsten Bewertungen behalten möchten.

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
  -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",
    "limit": 5,
    "target_duration": "DURATION_60_90",
    "enable_export": true,
    "resolution": "HD_720",
    "enable_caption": true,
    "enable_ai_reframe": true,
    "ratio": "RATIO_9_16"
  }'

Clipping-Ergebnisse abrufen

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

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

{
  "data": {"id": "proj_xyz789", "status": "SUCCEEDED", "expire_at": 1741824000000, "cost_usage": 120.0,
           "clips": [{"idx": 0, "title": "sample title", "begin_ms": 15000, "end_ms": 75000,
                      "tags": ["insight"], "desc": "sample description", "score": 81,
                      "export_link": "https://cdn.example.com/export/clip_001.mp4"}]}
}
{
  "data": {"id": "proj_abc123", "status": "SUCCEEDED", "expire_at": 1741824000000, "cost_usage": 120.0,
           "clips": [{"idx": 0, "title": "sample title", "begin_ms": 15000, "end_ms": 75000,
                      "tags": ["insight"], "desc": "sample description", "score": 81}]}
}

Antwortfelder

FeldTypBeschreibung
idstringEindeutige Aufgaben-ID
namestringAufgabenname
statusstringCREATED, QUEUED, ONGOING, SUCCEEDED, FAILED
error_messagestringFehlerursache (nur wenn FAILED)
expire_atintegerAblauf-Zeitstempel in Millisekunden
cost_usagenumberVerbrauchte API-Einheiten
clipsarrayListe der Clip-Objekte

Clip-Objekt

FeldTypBeschreibung
idxintegerClip-Index (ab 0, nach Viralpotenzial sortiert)
titlestringKI-generierter Titel
begin_msnumberStartzeit in Millisekunden
end_msnumberEndzeit in Millisekunden
thumbnailstringMiniaturansicht-URL
tagsstring[]KI-generierte Hashtags
descstringKI-generierte Beschreibung
scorenumberViralpotenzial-Score (0–100)
export_linkstringDownload-URL des gerenderten Videos. Läuft nach 24 Stunden ab.

Bestehende Clips erneut exportieren

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


FAQ

Wie lang darf das Video maximal sein?

Es gibt keine feste Längenbegrenzung — die API ist auf stundenlange Inhalte wie Podcasts, Gaming-Livestreams und Webinare ausgelegt. Dateigrößenbeschränkungen gelten nur für lokale Uploads; URL-basierte Quellen sind nicht begrenzt.

Wie werden Clips eingestuft?

Jeder Clip wird nach seinem Viralpotenzial bewertet — narrative Vollständigkeit, Hook-Stärke, emotionale Höhepunkte und Engagement-Signale. Verwenden Sie den limit-Parameter, um nur die Top-N-Clips mit der höchsten Bewertung zu behalten.

Kann ich Clips erhalten, ohne sie zu rendern?

Ja. Lassen Sie enable_export weg (oder setzen Sie es auf false), um nur Zeitstempel, Titel, Beschreibungen und Tags zu erhalten. Rendern Sie ausgewählte Clips später mit der Clips-Export-API.

Welche Seitenverhältnisse unterstützt AI Reframe?

RATIO_9_16 (TikTok / Reels / Shorts), RATIO_1_1 (Instagram-Feed), RATIO_4_5 (Instagram-Portrait) und RATIO_16_9 (Querformat). Siehe die Reframe-Layout-Werte für Layout-Optionen pro Seitenverhältnis.

Von welchen Plattformen kann ich clippen?

YouTube, Vimeo, Dailymotion, Kick, Twitch, TikTok, Facebook, Zoom, Rumble und mehr, plus lokal hochgeladene Dateien (mp4, mov, webm, avi).