n8n 工作流程

n8n 影片工作流程整合

使用 n8n，你可以透過 HTTP request、自訂 JavaScript 轉換、scheduled jobs、webhook、database 與 self-hosted infrastructure，建立對開發者友善的 WayinVideo 工作流程。

當你想更細緻地控制 credentials、retry 行為、storage、自訂程式碼，以及大規模影片處理流程時，n8n 很適合。

透過 WayinVideo API 與 n8n，你可以建立 self-hosted 影片自動化，用於 YouTube 到短片的 pipeline、私有檔案處理、排程內容營運、database-backed polling，以及自訂 CMS 整合。

WayinVideo 不需要專屬的 n8n node。你可以使用 WayinVideo API key，透過 HTTP Request node 連線。

n8n 可以自動化什麼

• YouTube 到短片工作流程：監看 RSS feed 或頻道 record，產生含標題、描述、主題標籤、score 與 export link 的短片。
• 私有影片處理：使用 Upload API 上傳本機檔案，並執行片段擷取、摘要、轉錄或 moments 搜尋。
• 排程輪詢：使用 Cron workflow 處理佇列中的影片，並隨時間檢查尚未完成的任務。
• 自訂轉換：使用 Function node，在儲存前重整摘要、逐字稿與片段 metadata。
• 內部系統整合：將結果傳送到 database、CMS tools、webhook、Slack、Google Sheets 或內部審核 app。

運作方式

多數 n8n 工作流程會遵循以下模式：

1. 觸發：從 Cron node、Webhook node、RSS trigger、storage event 或 database query 開始。
2. 提交：使用 HTTP Request node 呼叫 WayinVideo API endpoint。
3. 儲存：將回傳的任務 id 存到 database、sheet 或 workflow item。
4. 輪詢：使用 scheduled runs 或 loop logic 呼叫 result endpoint，直到 status 為 SUCCEEDED 或 FAILED。
5. 轉換：使用 Function node 重整片段 metadata、摘要、逐字稿或 export link。
6. 交付：將結果傳送到 CMS、database、Slack、Google Sheets、社群審核佇列或內部 webhook。

檢查任務狀態時，建議每 30 秒輪詢一次。

範例：YouTube RSS 到社群短片 Pipeline

這個工作流程使用 AI Clipping API，將新的 YouTube 影片轉成可供審核或發布的短片輸出。

觸發： YouTube RSS feed，或用排程檢查新影片。

步驟：

1. 偵測新的 YouTube 影片 URL
2. 將 enable_export 設為 true，提交到 AI Clipping API
3. 輪詢直到 status 為 SUCCEEDED
4. 使用 Function node 格式化片段標題、描述、主題標籤、score 與 export_link 值
5. 將結果寫入 Google Sheets、database 或社群媒體審核佇列

適合： 需要可重複長片轉短片 pipeline 的 creator tools、媒體團隊與內部內容系統。

提交請求

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",
    "enable_export": true,
    "resolution": "HD_720",
    "enable_caption": true,
    "enable_ai_reframe": true,
    "ratio": "RATIO_9_16"
  }'

範例：上傳檔案、Find Moments 並儲存結果

這個工作流程使用 Upload API 處理私有檔案，並透過 Find Moments API 使用自然語言查詢搜尋影片。

觸發： cloud storage 中的新檔案，或內部上傳表單。

步驟：

1. 從 Upload API 請求 upload URL
2. 將本機檔案上傳到 pre-signed URL
3. 將回傳的 identity 作為 video_url 傳給 Find Moments API
4. 輪詢直到結果準備完成
5. 將符合的 moments、timestamps、titles、descriptions 與 hashtags 存到你的 CMS 或 database

適合： 管理私有影片檔案，而非公開影片 URL 的團隊。

Find Moments 請求

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": "file_abc123",
    "query": "product demo moments",
    "enable_export": false
  }'

範例：排程影片智慧處理任務

這個工作流程可依照佇列中的任務類型，使用 AI Clipping API、Find Moments API、Video Summarization API 或 Video Transcription API。

觸發： Cron schedule。

步驟：

1. 從 database 或 sheet 讀取待處理的影片 record
2. 將每筆 record 提交到正確的 WayinVideo endpoint
3. 儲存 task IDs 與 statuses
4. 在下一次 scheduled run 輪詢未完成任務
5. 當摘要、逐字稿或片段準備完成時通知團隊

適合： 想要可靠、可恢復的自動化，但不想維護 custom worker service 的工程團隊。

結果檢查

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"

建議使用的 API

最佳實務

• 將 API key 儲存在 n8n credentials 或受保護的 environment variables。
• 如果 polling 會跨多次 workflow execution，請將 task IDs 放在 persistent storage。
• 寫入 CMS、database 或 spreadsheet 前，使用 Function node 正規化結果。
• 為 FAILED response 與 request timeout 加入 retry 與 failure paths。
• 對大型佇列，使用 Cron-based polling，而不是讓單一 workflow execution 開太久。
• 如果工作流程需要長期存取片段，請在匯出後將 export_link 檔案複製到自己的儲存空間。

FAQ

WayinVideo 有原生 n8n node 嗎？

你可以透過 n8n 的 HTTP Request node 連接 WayinVideo API，不需要專屬的 n8n node。

n8n 可以自動化 YouTube 影片片段擷取嗎？

可以。使用 RSS、schedule、database 或 webhook trigger 偵測 YouTube URL，提交到 AI Clipping API，再儲存回傳的 clips 與 export links。

n8n 可以處理私有影片檔案嗎？

可以。先用 Upload API 上傳檔案，再將回傳的 identity 作為 video_url 傳給 AI Clipping、Find Moments、Video Summarization 或 Video Transcription。

在 n8n 中輪詢 WayinVideo 任務的最佳方式是什麼？

小型 workflow 可以在同一次 execution 中輪詢。較大的佇列建議使用 Cron-based polling 與 persistent task storage，讓工作流程保持可恢復且可靠。