Clips-Export-API

April 1, 2026

Clips-Export-API

Verwenden Sie diese API, wenn Sie bereits eine Aufgabe KI-Clipping oder Momente finden erstellt haben und Clips später rendern oder mit anderen Einstellungen neu exportieren möchten.

Die project_id sollte die ursprüngliche Aufgaben-ID von:

  • POST /api/v2/clips
  • POST /api/v2/clips/find-moments

Export-Aufgabe einreichen

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

Anfragekörper

ParameterTypErforderlichStandardBeschreibung
project_idstringJaUrsprüngliche KI-Clipping- oder Momente-finden-Aufgaben-ID.
clip_indicesinteger[]NeinnullZu exportierende Clip-Indizes. Wenn weggelassen, alle Clips.
target_langstringNeinnullZielsprache für Untertitel.
resolutionstringNeinSD_480Auflösung: SD_480, HD_720, FHD_1080, QHD_2K, UHD_4K.
enable_captionbooleanNeinfalseAnimierte Untertitel hinzufügen.
caption_displaystringNeinoriginalUntertitelmodus: both, original, translation.
cc_style_tplstringNeintemp-7Untertitelstil-Vorlagen-ID.
enable_ai_hookbooleanNeinfalseKI-generierten Aufmerksamkeitstext hinzufügen.
ai_hook_script_stylestringNeinseriousHook-Textstil.
ai_hook_positionstringNeinbeginningPosition: beginning, end.
ai_hook_keywordsstringNeinnullOptionale Schlüsselwörter für den KI-Hook-Text.
ai_hook_text_durationintegerNeinnullDauer der Hook-Text-Überlagerung in Millisekunden.
enable_ai_reframebooleanNeinfalseKI-Reframing aktivieren.
ratiostringErforderlich wenn enable_ai_reframe trueSeitenverhältnis: RATIO_9_16, RATIO_1_1, RATIO_4_5, RATIO_16_9.
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips/export \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{"project_id": "proj_abc123", "clip_indices": [0, 2], "resolution": "UHD_4K", "enable_caption": true, "enable_ai_reframe": true, "ratio": "RATIO_9_16"}'
{"data": {"export_task_id": "export_task_xyz789", "name": "sample export task", "status": "CREATED"}}

Export-Ergebnisse abrufen

GET https://wayinvideo-api.wayin.ai/api/v2/clips/export/{taskId}
curl -X GET https://wayinvideo-api.wayin.ai/api/v2/clips/export/export_task_xyz789 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2"
{"data": {"export_task_id": "export_task_xyz789", "status": "SUCCEEDED",
          "expire_at": 1775831883112, "cost_usage": 48.0,
          "clips": [{"idx": 0, "title": "sample title", "begin_ms": 15000, "end_ms": 75000,
                     "score": 81, "export_link": "https://cdn.example.com/export/clip_001.mp4"}]}}