AI 剪輯 API

AI 剪輯 API

提交任意長度的影片，取得所有依傳播潛力排序的短片。每個片段包含自動偵測的起止時間點、AI 生成的標題、描述與主題標籤。API 支援從短片到數小時長片的各種影片。若開啟匯出功能，回應中也會包含每個片段的算圖影片下載連結，並可選擇啟用 AI 重新構圖（自動將主體保持在畫面中央）以及動態字幕疊加，讓短影音更吸引眼球。

你可以將 AI 剪輯產生的短片直接發布到已綁定的社群媒體帳號。請參考社群媒體發布 API 來綁定帳號並建立發布任務。

支援的影片來源

API 接受以下平台的網址：YouTube、Vimeo、Dailymotion、Kick、Twitch、TikTok、Facebook、Zoom、Rumble 等。

也可以剪輯本機上傳的影片檔案——本機上傳需要 Starter 訂閱計劃或以上。

提交剪輯任務

從影片網址提交一個新的 AI 剪輯任務。

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

請求本體

算圖時，可以啟用動態字幕、AI 重新構圖以及可選的 AI 開場文字等功能。AI 重新構圖會偵測畫面中的主體，在保持主體居中的前提下，針對指定的畫面比例最佳化裁切，並根據場景結構選擇最適合的版面配置。這些功能透過名稱以 enable_ 開頭的參數控制（詳見下表）。

版面配置值

reframe_layout 的允許值取決於 ratio。Auto 永遠可用（預設）；省略欄位或傳入空字串效果相同。版面名稱需完全符合以下列表（區分大小寫與空格）。

enable_export 行為說明

• enable_export 為空值或 false 時，API 只回傳片段的時間範圍、標題、描述與相關詮釋資料，不進行算圖，結果中也不含下載連結。ratio、reframe_layout、resolution、caption_display、enable_caption、cc_style_tpl、enable_ai_hook、ai_hook_script_style、ai_hook_position、enable_ai_reframe 等參數在提交任務時不生效。之後可透過匯出現有片段端點對選定片段進行算圖。
• enable_export 為 true 時，上述參數生效，每個片段立即算圖，結果中包含每個片段的下載連結。由於每個片段都需要算圖，處理時間可能更長。

請求本體將 enable_export 設為 true，片段算圖後，每個片段都包含 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",
    "project_name": "sample project name",
    "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 或設為 false，只回傳片段的時間範圍、標題、描述與標籤，不算圖，無下載連結。

請求

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",
    "project_name": "sample project name",
    "target_duration": "DURATION_30_60"
  }'

提交回應

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

使用範例

常見的 AI 剪輯情境。請將 YOUR_API_KEY 替換為從 API Dashboard 取得的金鑰。

將 YouTube 影片剪輯成高傳播短片

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

將網路研討會錄影剪輯成 9:16 直式短片並加上字幕

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

將 Podcast 剪輯成排名最高的短片

適合長篇內容，只想取得傳播分數最高的片段。

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

取得剪輯結果

取得任務狀態與片段列表。持續輪詢此端點，直到 status 為 SUCCEEDED。

增量回傳： 當 status 為 ONGOING 時，每次呼叫都會回傳目前已生成的片段——你可以立即開始處理部分結果。當 status 變為 SUCCEEDED 時，回應才包含完整的片段列表。

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

路徑參數

請求範例

curl -X GET https://wayinvideo-api.wayin.ai/api/v2/clips/results/proj_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2"

任務提交時設定了 enable_export: true，每個片段都包含算圖影片的 export_link：

{
  "data": {
    "id": "proj_xyz789",
    "name": "sample project name",
    "status": "SUCCEEDED",
    "expire_at": 1741824000000,
    "cost_usage": 120.0,
    "clips": [
      {
        "idx": 0,
        "title": "sample title",
        "begin_ms": 15000,
        "end_ms": 75000,
        "thumbnail": "https://cdn.example.com/thumb/clip_001.jpg",
        "tags": ["insight", "analysis"],
        "desc": "sample description",
        "score": 81,
        "export_link": "https://cdn.example.com/export/clip_001.mp4"
      },
      {
        "idx": 1,
        "title": "sample title 2",
        "begin_ms": 120000,
        "end_ms": 195000,
        "thumbnail": "https://cdn.example.com/thumb/clip_002.jpg",
        "tags": ["tips", "summary"],
        "desc": "sample description",
        "score": 76,
        "export_link": "https://cdn.example.com/export/clip_002.mp4"
      }
    ]
  }
}

任務提交時未設定 enable_export（或設為 false），片段不包含 export_link：

{
  "data": {
    "id": "proj_abc123",
    "name": "sample project name",
    "status": "SUCCEEDED",
    "expire_at": 1741824000000,
    "cost_usage": 120.0,
    "clips": [
      {
        "idx": 0,
        "title": "sample title",
        "begin_ms": 15000,
        "end_ms": 75000,
        "thumbnail": "https://cdn.example.com/thumb/clip_001.jpg",
        "tags": ["insight", "analysis"],
        "desc": "sample description",
        "score": 81
      },
      {
        "idx": 1,
        "title": "sample title 2",
        "begin_ms": 120000,
        "end_ms": 195000,
        "thumbnail": "https://cdn.example.com/thumb/clip_002.jpg",
        "tags": ["tips", "summary"],
        "desc": "sample description",
        "score": 76
      }
    ]
  }
}

回應欄位

片段物件

重新匯出現有片段

若想稍後才算圖，或以不同的字幕樣式、畫面比例、AI 開場文字或其他設定重新匯出，請使用 Clips Export API。

對於 AI 剪輯任務，請將 POST /api/v2/clips 回傳的任務 id 作為匯出請求中的 project_id。

常見問題

影片最長可以多長？

沒有硬性的長度限制——API 專為數小時長的內容設計，例如 Podcast、遊戲直播、網路研討會。檔案大小限制僅適用於本機上傳；網址來源沒有上限。

片段如何排序？

每個片段都會依傳播潛力評分——包含敘事完整性、開場吸引力、情緒高峰與互動訊號等。可使用 limit 參數只保留分數最高的前 N 個片段。

可以只取得片段而不算圖嗎？

可以。省略 enable_export（或設為 false），就只會回傳時間點、標題、描述與標籤。日後可使用 Clips Export API 針對選定片段進行算圖。

AI Reframe 支援哪些畫面比例？

RATIO_9_16（TikTok / Reels / Shorts）、RATIO_1_1（Instagram 動態消息）、RATIO_4_5（Instagram 直式）以及 RATIO_16_9（橫式）。各比例可用的版面配置請參見版面配置值。

可以從哪些平台剪輯？

YouTube、Vimeo、Dailymotion、Kick、Twitch、TikTok、Facebook、Zoom、Rumble 等，以及本機上傳的檔案（mp4、mov、webm、avi）。