快速入門

跟著以下步驟，幾分鐘內就能開始使用 WayinVideo API。

1. 取得你的 API 金鑰

登入 WayinVideo API Dashboard
點擊 Create API Key 生成新的金鑰
複製並妥善保存你的 API 金鑰

重要： API 金鑰屬於機密資訊，請勿在前端程式碼或公開的程式碼庫中洩露。

2. 提交剪輯任務

傳送影片網址以提交一個 AI 剪輯任務：

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",
    "enable_export": false
  }'

回應：

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

3. 輪詢取得結果

持續輪詢任務狀態，直到出現 SUCCEEDED。建議每 30 秒輪詢一次。

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"

處理完成後，回應中會包含你的剪輯片段：

{
  "data": {
    "id": "proj_abc123",
    "name": "sample project name",
    "status": "SUCCEEDED",
    "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"
      }
    ]
  }
}

注意： 提交剪輯任務時，可以設定 enable_export = true，讓系統算圖並匯出影片，回應中會包含下載連結。由於算圖與匯出需要額外的處理時間，完成時間會比不開啟匯出時更長。

4. 匯出與發布短片

短片生成後，你可以將它們算圖成影片檔，或直接發布到已綁定的社群媒體帳號：

短片匯出 API — 使用自訂解析度、字幕、AI 重新構圖、AI Hook 與其他匯出設定來算圖或重新匯出短片。
社群媒體發布 API — 綁定社群媒體帳號，並發布 AI 剪輯或時刻搜尋產生的短片。

接下來

AI 剪輯 — 從長影片中取得高傳播潛力短片
時刻搜尋 — 用自然語言查詢影片中的特定時刻
影片摘要 — 取得影片的概覽與時間軸重點
影片轉錄 — 提取字詞級別的逐字稿，並支援說話者分離
AI for Stream Videos — 探索適用於即時串流影片工作流程的直播理解與剪輯。